# 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](https://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](https://git.mortdec.ai/Mortdecai/mortdecai-api).

A training example is a prompt + expected output:

```json
{
  "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
