斯芬克斯谜题

斯芬克斯谜题

Minecraft 服务器问答竞赛系统

迷你游戏

Sphinx Riddle - Minecraft 问答竞赛模组

logo

🎮 适用于 Minecraft 服务器的问答竞赛系统

release issues license


功能特性

  • 自动问答系统

    • 可配置定时的自动出题间隔
    • 问题超时处理
    • 基于 JSON 的问题与奖励配置
  • 智能答案检测

    • 基于包含关系的答案匹配(例如,“龟派气功”可匹配“气功”)
    • 不区分大小写匹配
    • 首位答对玩家获胜机制
  • 奖励系统

    • 从可配置奖励池中随机选择奖励
    • 可变奖励数量
    • 使用 MC 物品选择器自动补全物品
  • 计分板与排名

    • 客户端实时计分板显示(可配置)
    • 前 15 名玩家排名,名次位置带颜色
    • 持久化分数存储
  • 全面的命令

    • 玩家命令:/sr question(权限可配置)
    • 管理员命令:问题/奖励管理、计分板控制
    • 基于权限的命令访问
  • 便捷配置

    • JSON 配置文件
    • 支持热重载
    • 可自定义消息与间隔
  • 国际化(i18n)

    • 完整的英文与中文语言支持
    • 根据客户端设置自动检测语言
    • 易于添加更多语言

快速开始

安装

  1. 从 Releases 下载最新的 sphinxriddle-x.x-NeoForge-1.21.x.jar
  2. 将其放入服务器的 mods 文件夹
  3. 重启服务器

基本用法

对于玩家:

  • 当问题出现时,直接在聊天中回答
  • 使用 /sr question 手动开始新问题(如果配置允许)
  • 在右侧计分板查看你的排名(如果启用)

对于管理员:

# 重载配置
/sr reload

# 添加问题
/sr add question "What tool mines diamond?" "Iron Pickaxe"

# 添加奖励(支持自动补全)
/sr add reward minecraft:diamond 5

# 管理排名
/sr list ranking
/sr reset ranking

配置

主配置(config/sphinxriddle-client.toml)

该模组使用 NeoForge 的配置系统,包含以下选项:

设置 默认值 描述 questionInterval 300 自动出题间隔(秒) questionTimeout 60 问题过期前的时间(秒) autoQuestionEnabled true 启用自动出题 allowManualQuestion true 允许玩家使用 /sr question showScoreboard true 在客户端显示计分板 questionPrefix "&6[问答]&r " 问题消息前缀 rewardMessage "&a恭喜 %player% 正确回答问题!获得奖励: %reward%" 奖励公告消息 newQuestionMessage "&e新问题: %question% &e(输入答案到聊天框)" 新问题公告 configReloadedMessage "&aSphinxRiddle 配置重载完成" 配置重载消息

配置文件中的提示信息默认使用中文。如需其他语言,请相应修改配置文件

数据文件(config/sphinxriddle/)

· questions.json - 问题与答案对 · rewards.json - 奖励物品与最大数量 · scoreboard.json - 玩家分数与排名

配置示例

questions.json:

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

rewards.json:

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

命令参考

玩家命令

命令 描述 权限 /sr question 开始一个新问题 所有玩家(若 allowManualQuestion=true)或仅 OP

管理员命令

命令 描述 权限 /sr reload 重载配置 OP (2) /sr add question 添加新问题 OP (2) /sr add reward 添加奖励物品 OP (2) /sr list question 列出所有问题 OP (2) /sr list reward 列出所有奖励 OP (2) /sr list ranking 显示排行榜 OP (2) /sr reset ranking 重置分数 OP (2) /sr remove question 移除问题 OP (2) /sr remove reward 移除奖励 OP (2)

语言支持

该模组根据客户端语言设置自动支持多种语言:

· English (en_us) - 默认语言 · 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

该模组将自动以玩家客户端语言显示文本。若某种语言未完全翻译,将回退到英文。

添加新语言

要添加对新语言的支持:

  1. 在 assets/sphinxriddle/lang/ 中创建一个新的 JSON 文件(例如 fr_fr.json)
  2. 使用与 en_us.json 相同的键添加翻译
  3. 模组将自动检测并使用合适的语言

语言文件结构示例:

{
  "sphinxriddle.command.help.title": "=== Commandes SphinxRiddle ===",
  "sphinxriddle.command.help.question": "/sr question - Démarrer une nouvelle question"
  // ... 更多翻译
}

开发

从源码构建

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

环境要求

· Minecraft 1.20.1+ · NeoForge · Java 17+

国际化

该模组使用 Minecraft 的 Component.translatable() 系统处理所有面向用户的文本。添加新功能时:

· 使用翻译键而不是硬编码字符串 · 在 en_us.json 和 zh_cn.json 中同时提供翻译 · 需要时使用 %s 占位符进行字符串插值

示例:

// 而不是:
Component.literal("Configuration reloaded")

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

支持

· GitHub Discussions - 用于提问与支持 · Issue Tracker - 用于缺陷报告与功能请求

许可证

本项目采用 GNU LGPL 2.1 许可证 - 详情请参阅 LICENSE 文件。


注意:

  1. 计分板显示与手动出题命令可在配置文件中禁用,以便进行服务器自定义。
  2. 配置文件中的提示信息默认使用中文。如需其他语言,请相应修改配置文件