Skip to content

AGENTS.md

Latest commit

 

History

History
54 lines (37 loc) · 2.04 KB

AGENTS.md

File metadata and controls

54 lines (37 loc) · 2.04 KB

challenge-assignment-plugin-server-java

An Extend Override app for the challenge assignment function written in Java. AGS calls this gRPC server to execute custom challenge goal assignment logic instead of the default behavior.

This is a template project — clone it, replace the sample logic in the service implementation, and deploy.

Build & Test

./gradlew build                      # Build with Gradle
./gradlew test                       # Run tests
docker compose up --build            # Run locally with Docker
./gradlew generateProto              # Regenerate proto code

Architecture

AGS invokes this app's gRPC methods instead of its default logic:

Game Client → AGS → [gRPC] → This App → Response → AGS

The sample implementation randomly selects one goal from the list of active goals and assigns it to the requesting user.

Key Files

Path Purpose
src/main/java/net/accelbyte/challenge/assignment/App.java Entry point — starts gRPC server, wires interceptors and observability
src/main/java/net/accelbyte/challenge/assignment/service/ChallengeAssignmentService.java Service implementation — your custom logic goes here
src/main/proto/assignment_function.proto gRPC service definition (AccelByte-provided, do not modify)
docker-compose.yaml Local development setup
.env.template Environment variable template

Rules

See .agents/rules/ for coding conventions, commit standards, and proto file policies.

Environment

Copy .env.template to .env and fill in your credentials.

Variable Description
AB_BASE_URL AccelByte base URL (e.g. https://test.accelbyte.io)
AB_CLIENT_ID OAuth client ID
AB_CLIENT_SECRET OAuth client secret
AB_NAMESPACE Target namespace
PLUGIN_GRPC_SERVER_AUTH_ENABLED Enable gRPC auth (true by default)

Dependencies

  • AccelByte Java SDK (net.accelbyte.sdk:sdk) — AGS platform SDK and gRPC plugin utilities