cal/paper-dynasty-discord
1
0
Fork 0
Code Issues 14 Pull Requests 2 Actions Packages Projects Releases Wiki Activity
9d37e3a190
paper-dynasty-discord/CLAUDE.md
Cal Corum 9d37e3a190 Optimize CLAUDE.md from 119 to 31 lines 
Remove generated architecture docs, vague data flow sections, and boilerplate.
Keep commands, key patterns, and development notes.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-14 08:33:47 -06:00

1.0 KiB
Raw Blame History

Paper Dynasty Discord Bot

Baseball card game Discord bot. discord.py with cog-based commands, SQLModel for database ops.

Commands

python -m pytest                    # Run tests
python paperdynasty.py              # Start bot
pip install -r requirements.txt     # Install dependencies

Architecture

  • Cogs (cogs/): Command modules — gameplay, economy, players, admins
  • Game engine (in_game/): Turn-based simulation, AI manager, dice mechanics, WPA calculations
  • UI (utilities/): Buttons, dropdowns, embeds
  • Database: Production uses FastAPI database directly; dev may use separate PostgreSQL via SQLModel

Key Patterns

  • Cards generated from MLB statistics with complex rating calculations
  • Card ratings split by handedness (vs_hand: 'R' or 'L')
  • Multiple cardsets (seasons) with different priorities for gameplay
  • Use factory data in testing as often as possible

Development Notes

  • Connect to proper docker socket when running tests
  • Plans go in ./.claude/plans/ with descriptive filenames