A lightweight multiplayer game backend built on Netty and Protobuf.

• WebSocket game server (ServerMain)
• Command-handler architecture with reflection-based registration
• Redis-backed ranking service
• Optional RocketMQ integration for async rank updates
• MyBatis + MySQL login persistence

• valorlegend/ - Java source, tests, and Maven build
• deploy/mysql/init/ - MySQL bootstrap schema
• .github/workflows/ci.yml - CI pipeline (mvn verify)

• JDK 8+
• Maven 3.8+
• Docker + Docker Compose v2 (for containerized deployment and integration tests)
• GNU Make (optional, for shortcut commands)

Optional (for full runtime features):

• MySQL
• Redis
• RocketMQ

mvn -f valorlegend/pom.xml clean verify
java -jar valorlegend/target/valorlegend-1.1.0.jar

Or use Make shortcuts:

make verify
make docker-up

Default server port: 12345

Configuration can be passed via JVM properties or environment variables.

Legacy herostory.* and HERO_STORY_* keys are still supported for backward compatibility.

docker compose up --build

This starts:

• game-server
• mysql
• redis

RocketMQ + ranking worker can be started with profile:

docker compose --profile full up --build

• Unit tests: JUnit 5
• Coverage: JaCoCo check in verify
• CI: GitHub Actions for unit tests and coverage on all pushes/PRs
• Integration CI: Docker-backed MySQL/Redis tests on pull requests and pushes to main

The repository provides a Docker integration profile and an executable test script.

./scripts/run-integration-tests.sh

This command will:

• start mysql-it and redis-it with Docker profile integration
• run Maven integration tests (ExternalDependenciesIT) via profile integration-tests
• clean up containers automatically

• Contribution guide: CONTRIBUTING.md
• Code of conduct: CODE_OF_CONDUCT.md
• Security policy: SECURITY.md
• Support channels: SUPPORT.md

MIT - see LICENSE.