Mortdecai/CONTRIBUTING.md

Contributing to Mortdecai

Mortdecai improves through player interactions. Every prayer, sudo command, and bug report becomes training data for the next version.

How to Contribute

Play on the Server

The simplest way to contribute: join the Minecraft server and interact with the AI.

Join: minecraft.mortdec.ai

Things that generate valuable training data:

• Edge cases — unusual items, complex enchantments, multi-step requests
• Natural language variety — typos, slang, sarcasm, multiple languages
• Bug reports — type bug_log <description> when something goes wrong
• Boundary testing — try requesting things the AI shouldn't do

Submit Training Data (API)

When the public API launches, you'll be able to submit training examples directly and earn inference credits. See the API concept.

A training example is a prompt + expected output:

{
  "prompt": "sudo give me a trident with riptide 3 and loyalty 3",
  "expected_output": {
    "commands": [],
    "reasoning": "Riptide and loyalty are mutually exclusive"
  }
}

Valuable contributions:

• Commands the model gets wrong
• Modded server commands
• Non-English prompts
• Negative examples ("this should fail because...")

Report Issues

• In-game: bug_log <description>
• Gitea: Open an issue on the relevant repo

What NOT to Submit

• Commands containing real player data or personal information
• Deliberately adversarial training data designed to make the model unsafe
• Copyrighted content
• Anything that violates the Minecraft EULA

Code of Conduct

• Be respectful in all interactions
• Report safety issues responsibly
• Don't attempt to bypass the risk hierarchy
• Have fun — this is a game, after all