mc/AGENTS.md

Tarna Minecraft Bedrock Server / Dragonfly

Run

• go run main.go — start server (uses config.toml; auto-created if missing)
• go build -o mc_server main.go && ./mc_server — build + run
• make lint — run golangci-lint with govet, staticcheck, ineffassign, gocritic
• go test ./... — all tests (only 2 test files exist; deterministic world tests use world.Config{Synchronous: true})
• CI runs make lint then go test ./... on every PR/push

Architecture

• main.go — entry point; adds custom mob spawner (every 20s), item cleaner (every 15min), cooperative random spawn, admin-only commands (2 hardcoded admins)
• server/ — the Dragonfly library: server.go (core), conf.go (config), session/ (network protocol), cmd/ (command framework), block/, entity/, world/ (world + generators + LevelDB storage)
• cmd/blockhash/ — standalone utility for block hash generation
• config.toml — runtime config (TOML); network address, world folder, chunk radius, resource packs, etc.

Code conventions

• Module: github.com/df-mc/dragonfly (Go 1.26)
• British English in docs, symbols, variables
• gofmt formatting; 3+ sequential vars grouped into var() block
• Minimize exported symbols; conservative use of generics
• eol=lf for all .go files (.gitattributes)

Generated files (DO NOT EDIT)

• server/session/enchantment_texts.go — autogenerated by CI from GitHub contributor list

Deploy (push to master only)

• Builds binary → SCPs to VPS → stops old server via screen → starts new binary in screen -S dragonfly
• PRs deploy test server to df-mc.dev/pullrequest/<PR#> for review

Data / runtime

• World data stored in world/, player data in players/, resource packs in resources/ (all gitignored)
• bans.json for multi-factor ban system by username/XUID/UUID/IP