The repository is currently privated and the bot is offline (with no future plan to continue the project), if someone still seeks access to the source code or wishes to test the features, feel free to contact me.

What is Disclawd?

What is Disclawd? Disclawd is a clicker game for Discord. It’s possible to “mine” blocks and ores from a pretty familiar game, doing this grants gold, xp and allows one to buy items. Besides that watch out to slay spawning monsters!

This idea was realized by writing a Discord bot in Java using the Java Discord API (JDA). It was one way to express my passion for games, art and coding. As, for example, all item art was done by myself.

Not a Stick Not a Stick Not a Stick Magic Stone Reduvia

Details

Architecture

  • Items, blocks, and mobs are defined in JSON config files, making the system modular and easily extendable.

{
  "blocks": [
    {
      "biome": "Overworld",
      "type": "COAL",
      "hp": 10.0,
      "fileName": "coal.png",
      "xpEnabled": true,
      "mobs": ["ZOMBIE", "SKELETON", "CREEPER"]
    }
  ]
}
  • Server-specific world instances isolate state per Discord guild, supporting multiple active servers simultaneously.
  • Caching used for frequently accessed objects, such as inventories, to minimize redundant computation and database hits during activity spikes.
  • Player stats and inventories are stored in a SQL database.

For Discord Users

  • Randomized block and block-specific mob spawning.
  • Per guild scaling, the more players interact, the harder are blocks to break.

Commands:

  • /help – Shows an ephemeral message explaining the game concept.
  • /rank [category] – Shows the Top 10 players (globally) by catergory. If you aren’t in the top 10, your global position is also displayed. Supports autocomplete.
  • /block – Displays the current block, its HP, and active users. Includes a hit button.
  • /shop – Opens a paginated shop interface (see pixel art above).
  • /item [item name] – Shows item info with buy/equip buttons. Supports autocomplete.
  • /inventory – Displays a paginated inventory, main stats are shown on the first page and collected items on further.