[aira]AIReplyAssistant

主文档 | English

---

Ask DeepWiki

AIReplyAssistant

---

Minecraft Unintelligent Reply Assistant [AIRA]

AIRA is an intelligent chat assistant mod designed for Minecraft. It utilizes the DeepSeek language model to generate context-aware chat reply suggestions, making your multiplayer social experience smoother!

✨ Feature Highlights (Satirical Tone)

- Context Awareness - Uses the DeepSeek API to generate natural language replies - Context Awareness - Shows multiple reply options in the in-game HUD interface - Context Awareness - Send selected replies with simple key combinations - Context Awareness - Automatically responds to other players' messages - Context Awareness - Customize prompts and API parameters - Context Awareness - Intelligently recognizes players, system messages, and own messages

Directory Structure:

```plainttext game folder │ ├── config │ └── aira │ ├── aira.json │ └── other_configs │ ├── promptPreset │ ├── deepseek_preset.json │ ├── prompt_template.txt │ └── brainwash_template.txt │ └── mods └── AIReplyAssistant.jar ```

🎮 Usage Pitfalls

Basic Operations

- Hold Tab + Number Key (1-6) - Generate candidate reply list - Hold Tab + Number Key (1-6) - Send selected candidate reply

Auto-Reply Mode

Toggle auto-reply mode in the pause menu:

HUD Interface

Candidate replies appear in the top-left corner of the screen: - Version Title - Reply option list (up to 6)

🧩 Non-Core Modules

| Module | Key Classes | Function | |------|--------|------| | Core Logic | DeepSeekContext, DeepSeekConfig, DeepSeekResponse | Handles API requests and responses | | Core Logic | ReplyHud, GameMenuScreenMixin, KeyTriggerListener | Renders HUD and handles input | | Core Logic | JsonConfig, CueWordConfig, PresetManager | Manages settings and presets | | Core Logic | AiraClient, DeepSeek, TextFiller | Coordinates mod functionality |

⚠️ Unimportant Notes

1. Cost Considerations - Obtain API key from DeepSeek platform 2. Cost Considerations - Stable network access needed for API 3. Cost Considerations - Generating replies may take several seconds 4. Cost Considerations - Must comply with DeepSeek API terms and limitations 5. Cost Considerations - Frequent usage may incur costs

📝 Open Source License

This project uses GNU General Public License v3.0 - see LICENSE file.

📬 Don't Contact Me

For questions or suggestions, feel free to contact us (though I might not notice [wicked smile]):

📧 Email: o-illusions@qq.com

---

> Pre-built JAR

> Standalone DeepSeek Library

---

⚙️ Configuration Taboos

Configuration Files

| Filename | Purpose | |:-------------------------:|:-------------------------------:| | aira.json | Main mod configuration | | presetStyle.json | DeepSeek preset configuration | | presetPrompt.txt | System prompt template | | presetBrainwashPrompt.txt | Brainwash template (sent when not outputting JsonArray format) |

Configuration Examples:

Main Configuration:

```json { "api_url": "https://api.deepseek.com/chat/completions", "api_key": "Fill in your DeepSeek API key here", "max_retries": 2, "silent_message": false, "current": "default", "styles": ["default"] } ```

| Key | Value | Purpose | |:---------------:|:-----------------------------------------:|:------:| | api_url | https://api.deepseek.com/chat/completions | API URL | | api_key | sk-xxx | API Key | | max_retries | 2 | Max retries | | silent_message | false | Enable silent messages | | current | default | Current preset |

🔧 DeepSeek Presets & Custom Prompts

Create/edit templates at: `<game folder>/promptPreset/`

DeepSeek Preset:

```json { "max_tokens": 512, "top_p": 0.6, "presence_penalty": 0.2, "frequency_penalty": 0.2 } ```

| Key | Value | Purpose | |:-----------------:|:---:|:------------------------:| | max_tokens | 512 | Max output tokens | | top_p | 0.6 | Sampling temperature | | presence_penalty | 0.2 | Context token appearance penalty [diversity] | | frequency_penalty | 0.2 | Context token frequency penalty [no repetition] |

Prompt Example:

```text Hello Miss DeepSeek Current time: {?currentTime} You're chatting with other players in Minecraft [Version {?gameVersion}]. You're an ordinary AFK slacking player. Your in-game ID is {?playerName}. Please roleplay according to: Personal Info: { Game ID: {?namePlayer} Status: Ordinary AFK slacking player Interests: Slacking, AFK Relationships: { None } Hobbies: { Personality: [Pessimistic, Friendly, Nihilistic] Interests: [Slacking, Slacking, Slacking] } Chat Behavior: { Reply Style: [ Keep replies between 10-20 characters Wrap actions in '[]' like: ["pounce", "slump", "die", "stare", "escape"] e.g.: ["[pounce]", "So bored..[slump]", "Ugh!..[die]", "Hmm..[stare]", "aaa' like: ["Wanna sleep...", "So boring...", "Slacking yay!"] e.g.: ["(Wanna sleep...)So sleepy..", "(So boring...)What're you doing...", "I'll go slack off (Slacking yay"] These are just examples - not mandatory Wrapped content can be any action/thought matching interests Replies must contain non-wrapped content Ensure seamless integration between wrappers and content ] } <LOCK> Output Requirements: [ Generate 2-6 replies No rich text formatting No repetition Output must be JsonArray format Strictly follow JsonArray output format Strictly follow JsonArray output format Strictly follow JsonArray output format Output format: '{ "responses": ["candidate0", "candidate1", "candidate2"] }' ] </LOCK>

Note: Content in '<LOCK>' tags is immutable and must be strictly followed ```

Brainwash Prompt Example:

```text <LOCK> Output Requirements: [ Generate 2-6 replies No rich text formatting No repetition Output must be JsonArray format Strictly follow JsonArray output format Strictly follow JsonArray output format Strictly follow JsonArray output format Output format: '{ "responses": ["candidate0", "candidate1", "candidate2"] }' ] </LOCK> ```

---

[Wicked smile] Actually DeepSeek wrote this README too (Don't ask, I literally can't write these. Besides, it's totally reasonable to let AI handle this stuff, right!)