TaigaCore - 核心库

TaigaCore 是作者开发的一系列插件的核心库，为其他插件提供多种基础功能支持，包括玩家消息处理、数据库连接、插件管理等。它具备多语言支持和自动更新检查能力，是许多插件稳定运行的基础。

💡核心功能

• 玩家消息处理：自动根据玩家客户端语言设置发送对应消息。
• 数据库支持：支持 MySQL、SQLite 和 MariaDB 数据库连接。
• Redis 支持：集成 Redis 用于数据缓存或通信。
• 插件管理器：内置更新检查与插件安装功能。
• 日志系统：可配置的日志记录级别。
• 多语言系统：支持自定义和修改语言文件。

多语言支持

TaigaCore 通过读取数据包自动检测玩家语言设置，并从 /plugins/TaigaCore/lang 文件夹中加载对应的语言文件。你可以在此文件夹中添加新的语言文件或修改现有文件。

当前支持的语言：

• English (US) - by bys1
• English (UK) - by bys1
• Dutch (NL) - by bys1
• German (DE) - by bys1
• LOLCAT - by bys1
• Pirate Speak - by bys1

自动更新与安装

• 每 30 分钟自动检查插件更新，并在控制台和拥有相应权限的玩家处通知。
• 使用命令 /taiga install <plugin> <version> 可在游戏内或控制台直接从 Spigot 下载并安装插件，新文件将替换 TaigaCore 配置中指定的旧文件。

注意：TaigaCore 插件自身的更新检查与安装功能目前暂不支持。

🎮安装步骤

• 下载所需版本的 TaigaCore，将其放入服务器的 plugins 文件夹。
• 重启服务器。
• TaigaCore 将自动下载并加载运行所需的核心 API。
• 根据需要配置插件（配置说明见下文）。
• 重启服务器以使配置更改生效。
• 现在你可以使用 /taiga install 命令下载其他插件了。

🔧命令列表

主命令为 /taigaplugin（别名：/taigapl, /taiga），需要权限 taigacore.taigaplugin。所有命令均支持 Tab 补全。

/taigaplugin 相关命令

• /taiga help

- 权限：`taigacore.taigaplugin.help`

- 显示命令列表。

• /taiga plugins

- 权限：`taigacore.taigaplugin.plugins`

- 显示作者插件列表及其在服务器上的状态。

• /taiga check <plugin>

- 权限：`taigacore.taigaplugin.check`

- 检查指定插件是否有可用更新。

• /taiga install <plugin> <version>

- 权限：`taigacore.taigaplugin.install`

- 下载并安装指定插件。

• /taiga delete <plugin>

- 权限：`taigacore.taigaplugin.delete`

- 从服务器删除指定插件。

• /taiga load <plugin>

- 权限：`taigacore.taigaplugin.load`

- 在服务器上加载指定插件。

• /taiga unload <plugin>

- 权限：`taigacore.taigaplugin.unload`

- 从服务器卸载指定插件。

• /taiga enable <plugin>

- 权限：`taigacore.taigaplugin.enable`

- 启用指定插件。

• /taiga disable <plugin>

- 权限：`taigacore.taigaplugin.disable`

- 禁用指定插件。

语言命令

第二个命令是 /language（别名：/lang），需要权限 taigacore.language。

• /language <locale>

- 权限：`taigacore.language`

- 将你的语言更改为指定的区域设置（如果支持）。格式应为 `xx_xx`，例如 `en_us`、`en_uk`、`lol_us`、`en_pt`、`de_at`。

✨权限列表

• taigacore.language - 允许使用 /language 命令设置语言。
• taigacore.taigaplugin - 允许使用 /taigaplugin 命令。
• taigacore.taigaplugin.help
• taigacore.taigaplugin.plugins
• taigacore.taigaplugin.check
• taigacore.taigaplugin.install
• taigacore.taigaplugin.delete
• taigacore.taigaplugin.load
• taigacore.taigaplugin.unload
• taigacore.taigaplugin.enable
• taigacore.taigaplugin.disable
• taigacore.taigaplugin.* - 授予所有 taigacore.taigaplugin 权限。
• taigacore.* - 授予所有 TaigaCore 权限。

⭐配置说明

config.yml

# 日志级别：INFO、NOTICE 或 DEBUG
logging: NOTICE
plugin-files:
  PowerPerms: 'PowerPerms.jar'
  PowerPerms-Wildcards: 'PowerPerms-Wildcards.jar'

• logging：决定 TaigaCore 的日志详细程度。

- `INFO`：仅显示警告、错误和一些基本插件消息。

- `NOTICE`：显示多种操作的信息。

- `DEBUG`：显示所有调试消息以帮助排查错误。

• plugin-files：指定插件安装时对应的 JAR 文件路径。如果更改此项，请确保同时重命名服务器上已存在的对应 JAR 文件。

lang/config.yml

default-language: 'en_us'
en_us: 'en_us.yml'
en_gb: 'en_uk.yml'
en_uk: 'en_uk.yml'
lol_us: 'lol_us.yml'
en_pt: 'en_pt.yml'
en_7s: 'en_pt.yml'
de_de: 'de_de.yml'
nds_de: 'de_de.yml'
swg_de: 'de_de.yml'
ksh_de: 'de_de.yml'
de_at: 'de_de.yml'
nl_nl: 'nl_nl.yml'
li_li: 'nl_nl.yml'

此文件管理所有语言映射。玩家加入时，TaigaCore 会根据其客户端区域设置在此文件中查找。如果找到，则使用指定的 YAML 文件发送消息；如果未找到，则使用 default-language 指定的默认语言。

lang/en_us.yml（示例）

此文件管理美式英语的所有玩家消息。其中像 %time% 这样的占位符会在消息发送给玩家时自动替换为实际值。

❓支持与帮助

Discord 帮助频道：https://discord.gg/e5QRdBw

如果你在安装设置插件时需要帮助、有改进建议或发现了 Bug，欢迎联系作者！作者会尽快提供帮助，通常在几小时内回复（作者时区为 CET/GMT+1）。

• 一般问题或建议：请在 Spigot 页面的 Discussion 版块或 Discord 的插件频道中发帖。
• 安装设置问题或故障：请通过 Spigot 私信联系作者，或在 Discord 插件频道中发帖。
• Bug 报告：请按以下步骤操作：

1.  将插件配置中的 `logging` 设置为 `DEBUG`。

2.  **重启服务器**（不要使用重载），并尝试复现错误（例如执行导致出错的命令）。

3.  如果错误再次出现，请在报告中包含：

- **完整的控制台日志**。在 Spigot 上使用 `[CODE][/CODE]` 标签，或粘贴到 http://paste.md-5.net/。请注意，控制台错误中的换行符可能被移除，请重新添加以便阅读。

- **相关插件的配置文件**。在 Spigot 上使用 `[CODE=YAML][/CODE]` 标签，或在 Discord 中作为文件发送，或粘贴到 http://paste.md-5.net/。

- （可选但强烈建议）服务器上所有已安装插件及其版本的列表。

🔧关于作者

你好！我是 Björn (bys1)，我的目标是创建功能丰富、内存占用高效的高质量插件。我致力于提供良好的支持，并认真对待所有建议和 Bug 报告。如有任何问题，请随时联系我！

💡服务条款

作者：bys1，本软件的唯一创作者和版权持有人。

软件：TaigaCore 插件。

您：购买和/或使用本软件的个人。

下载本软件即表示您同意以下条款和条件（及其未来版本）。违反条款可能导致您对 SpigotMC 和/或本软件的访问受到限制或取消。

• 您不得以任何方式对本软件进行逆向工程，包括但不限于反编译和/或修改本软件或其源代码。
• 您不得以任何方式重新分发本软件，包括但不限于将本软件用于商业目的或声称其为您所有。
• 本软件按“原样”提供，作者不对其功能提供任何保证。作者可能会发布包含错误修复和/或功能增补的更新。
• 作者不对本软件可能对您的服务器造成的任何损害负责。

**支持说明**

• 仅保证通过描述中提及的方式以英语提供支持。
• 除非另有说明，作者通常会在 48 小时内回复。
• 作者可能随时要求您提供插件列表、插件配置和/或控制台日志。
• 在以下情况下，作者可能忽略支持请求：

- 使用英语以外的语言提交请求；

- 因语法使用不当导致请求难以理解；

- 您对作者和/或本软件进行辱骂、刷屏或侮辱；

- 您未提供作者要求的数据。

• 在评论中提交的支持请求、新功能请求和 Bug 报告可能会被忽略。
• 作者可能随时更改这些条款，恕不另行通知。