Sphinx Riddle - Minecraft Quiz Competition Mod

🎮 Quiz Competition System for Minecraft Servers

Features

Auto Quiz System

• Automatic question intervals with configurable timing
• Question timeout handling
• JSON-based question and reward configuration

Smart Answer Detection

• Contains-based answer matching (e.g., "龟派气功" matches "气功")
• Case-insensitive matching
• First-correct-player wins system

Reward System

• Random reward selection from configurable pool
• Variable reward amounts
• Item auto-completion with MC's item selector

Scoreboard & Ranking

• Real-time scoreboard display on client side (configurable)
• Top 15 players ranking with colored positions
• Persistent score storage

Comprehensive Commands

• Player commands: /sr question (configurable permission)
• Admin commands: Question/reward management, scoreboard control
• Permission-based command access

Easy Configuration

• JSON configuration files
• Hot-reload support
• Customizable messages and intervals

Internationalization (i18n)

• Full English and Chinese language support
• Automatic language detection based on client settings
• Easy to add more languages

Quick Start

Installation

1. Download the latest sphinxriddle-x.x-NeoForge-1.21.x.jar from Releases
2. Place it in your server's mods folder
3. Restart the server

Basic Usage

For Players:

• Answer questions directly in chat when they appear
• Use /sr question to manually start a new question (if allowed by config)
• Check your ranking on the right-side scoreboard (if enabled)

For Admins:

# Reload configuration
/sr reload

# Add questions
/sr add question "What tool mines diamond?" "Iron Pickaxe"

# Add rewards with auto-completion
/sr add reward minecraft:diamond 5

# Manage rankings
/sr list ranking
/sr reset ranking

Configuration

Main Configuration (config/sphinxriddle-client.toml)

The mod uses NeoForge's configuration system with the following options:

The prompt information in the configuration file defaults to Chinese. If you need other languages, please modify the configuration file accordingly

Data Files (config/sphinxriddle/)

• questions.json - Question and answer pairs
• rewards.json - Reward items and maximum amounts
• scoreboard.json - Player scores and rankings

Example Configuration

questions.json:

[
  {
    "question": "What mob explodes in Minecraft?",
    "answer": "Creeper"
  }
]

rewards.json:

[
  {
    "itemId": "minecraft:diamond",
    "maxAmount": 5
  }
]

Commands Reference

Player Commands

Admin Commands

Language Support

The mod supports multiple languages automatically based on the client's language setting:

• English (en_us) - Default language
• Chinese (zh_cn) - 简体中文
• Spanish (es_es) - Español
• French (fr_fr) - Français
• German (de_de) - Deutsch
• Japanese (ja_jp) - 日本語
• Russian (ru_ru) - Русский
• Portuguese (pt_br) - Português Brasileiro
• Korean (ko_kr) - 한국어
• Italian (it_it) - Italiano

The mod will automatically display text in the player's client language. If a language is not fully translated, it will fall back to English.

Adding New Languages

To add support for a new language:

1. Create a new JSON file in assets/sphinxriddle/lang/ (e.g., fr_fr.json)
2. Add translations using the same keys as in en_us.json
3. The mod will automatically detect and use the appropriate language

Example language file structure:

{
  "sphinxriddle.command.help.title": "=== Commandes SphinxRiddle ===",
  "sphinxriddle.command.help.question": "/sr question - Démarrer une nouvelle question"
  // ... more translations
}

Development

Building from Source

git clone https://github.com/SkyDreamLG/SphinxRiddle.git
cd SphinxRiddle
./gradlew build

Requirements

• Minecraft 1.20.1+
• NeoForge
• Java 17+

Internationalization

The mod uses Minecraft's Component.translatable() system for all user-facing text. When adding new features:

• Use translation keys instead of hardcoded strings
• Provide translations in both en_us.json and zh_cn.json
• Use string interpolation with %s placeholders when needed

Example:

// Instead of:
Component.literal("Configuration reloaded")

// Use:
Component.translatable("sphinxriddle.command.reload.success")

Support

• GitHub Discussions - For questions and support
• Issue Tracker - For bug reports and feature requests

License

This project is licensed under the GNU LGPL 2.1 License - see the LICENSE file for details.

Note:

1. The scoreboard display and manual question commands can be disabled in the configuration file for server customization.

2. The prompt information in the configuration file defaults to Chinese. If you need other languages, please modify the configuration file accordingly