📢 AtsAnnounce

A simple Fabric server announcement mod that automatically broadcasts specific announcements to all players at regular intervals.

✨ Features

🕒 Automatic Broadcasting: Sends announcements automatically at configured intervals
🎨 Rich Text Support: Supports Minecraft color codes and formatting
🌈 Color Code Flexibility: Compatible with both § and & color codes
🌍 Multi-language Support: Built-in internationalization support
⚙️ Command Management: Commands for adding, modifying, and removing announcements
🔄 Hot Reload: Reload all configurations without server restart

💻 Command Reference

All commands require OP permission level 4. The base command is /ats-announce.

📊 Status Management

/ats-announce status - Display current announcement system status
/ats-announce status enable - Enable automatic announcements
/ats-announce status disable - Disable automatic announcements

⚙️ Configuration Management

/ats-announce reload - Reload configuration from file
/ats-announce interval <minutes> - Set announcement interval
/ats-announce language <language> - Set mod language (currently supports: en_us, zh_cn)

📝 Announcement Management

/ats-announce list - List all configured announcements
/ats-announce add <message> - Add new announcement (auto-generated name)
/ats-announce addwithname <name> <message> - Add new announcement (custom name)
/ats-announce modify <name> <message> - Modify existing announcement
/ats-announce remove <name> - Remove announcement by name

🚀 Manual Broadcasting

/ats-announce send - Immediately send the next announcement
/ats-announce send <name> - Send specific announcement by name

📁 Configuration File

The configuration file is located at config/ats-announce.json:

{
  "interval_minutes": 10,
  "use_&_color": true,
  "language": "zh_cn",
  "announcements": {
    "announcement1": "§aThis is§l the\nfirst default announcement using § symbols for color formatting.",
    "announcement2": "&bThis is&n the\nsecond default announcement using & symbols for color formatting.",
    "tip1": "When use_&_color is true, you can use either & or § for color codes. If set to false, only § will work.",
    "tip2": "When use_&_color is true, to display a literal & character in messages, escape it with &&.",
    "tip3": "interval_minutes only accepts integer values."
  }
}

📋 Configuration Options

Option	Type	Default	Description
`interval_minutes`	Integer	10	Automatic announcement interval
`use_&_color`	Boolean	true	Whether to support `&` color codes
`language`	String	"en_us"	Mod language
`announcements`	Object	{}	Announcement names and messages

🎨 Color Code Support

📌 Standard Minecraft Codes: Use § followed by color/format codes (e.g., §a for green)
🔄 Alternative Format: When use_&_color is true, you can use & instead of § (e.g., &a for green)
🔒 Escaping: When use_&_color is true, use && to display a literal & character
📄 Line Breaks: Use \n in messages for line breaks

🌐 Supported Languages

The mod currently supports:

English (en_us)
Simplified Chinese (zh_cn)

If you'd like to contribute your own language, please submit a PR on GitHub.

📦 Installation

Ensure your server is running Fabric
Download the mod JAR file
Place it in your server's mods folder
Restart the server
Use commands or edit the configuration file to set up your announcements

📖 Usage Examples

# Enable announcements with 15-minute intervals
/ats-announce status enable
/ats-announce interval 15

# Add a colorful welcome message
/ats-announce addwithname "welcome" "&6Welcome!&a Have fun playing!"

# Add a rules reminder
/ats-announce add "§cRules:\n§7Type /rules for more information"

# Send a specific announcement immediately
/ats-announce send welcome

❓ Frequently Asked Questions

Q: How do I create multi-line announcements?

A: Use \n in your announcement message to create line breaks.

Q: Color codes aren't working. What should I do?

A: Check the use_&_color setting in your configuration file and ensure you're using the correct color code format.

Q: How can I temporarily stop announcements?

A: Use /ats-announce status disable to disable automatic announcements.

Q: Where is the configuration file located?

A: The configuration file is located at config/ats-announce.json in your server's root directory.

Q: I'm getting a "Fabric Loader version too low (<0.16.14)" error

A: You have two options:

Update your Fabric Loader to the latest version.
Use an archive tool to open the mod JAR file, locate the fabric.mod.json file, and modify the depends -> fabricloader field, changing 0.16.14 to match your Fabric Loader version.

This issue occurs because the mod was compiled with a higher Fabric Loader version. However, since the mod has minimal functionality, it likely doesn't depend on specific Fabric Loader features, so you can try modifying fabric.mod.json for compatibility with older versions. If you encounter other issues, we recommend updating Fabric Loader unless you have specific requirements for using an older version.

Q: How can I add my own language or modify default messages?

A: Simply add or modify language files in the mod's lang folder using the format <language_code>.json. After adding a new language, add your language file name to languages.txt in the same directory, then set the language field in your configuration file to your language code. We welcome language file PRs on GitHub!

📢 AtsAnnounce

一个简单的 Fabric 服务器公告模组，每隔一段时间自动向所有玩家发送特定公告。

✨ 支持的功能

🕒 自动发送：按间隔时间自动发送公告
🎨 富文本支持：支持 Minecraft 颜色代码和格式化
🌈 颜色编码：同时支持 § 和 & 颜色代码
🌍 多语言支持：内置国际化支持
⚙️ 指令管理：有添加、修改和删除公告的命令
🔄 热重载：无需重启服务器即可重新加载所有配置

💻 指令解释

所有指令都需要 OP 权限等级 4。基础指令为 /ats-announce。

📊 状态管理

/ats-announce status - 显示当前公告系统状态
/ats-announce status enable - 启用自动公告
/ats-announce status disable - 禁用自动公告

⚙️ 配置管理

/ats-announce reload - 从文件重新加载配置
/ats-announce interval <分钟> - 设置公告间隔
/ats-announce language <语言> - 设置模组语言（目前支持：en_us, zh_cn）

📝 公告管理

/ats-announce list - 列出所有已配置的公告
/ats-announce add <消息> - 添加新公告（自动生成名称）
/ats-announce addwithname <名称> <消息> - 添加新公告（自定义名称）
/ats-announce modify <名称> <消息> - 修改现有公告
/ats-announce remove <名称> - 按名称删除公告

🚀 手动发送

/ats-announce send - 立即发送下一个公告
/ats-announce send <名称> - 按名称发送特定公告

📁 配置文件

配置文件位于 config/ats-announce.json：

{
  "interval_minutes": 10,
  "use_&_color": true,
  "language": "zh_cn",
  "announcements": {
    "公告一": "§a这个§l是\n第一个默认公告，用§符号可以设置颜色格式。",
    "公告二": "&b这个&n是\n第二个默认公告，用&符号可以设置颜色格式。",
    "提示1": "如果use_&_color为true，则可以使用&或§来设置颜色。但如果设置为false，则只能使用§。",
    "提示2": "当use_&_color为true时，如果你想在消息中显示&，可以用两个&来转义，如：&&。",
    "提示3": "interval_minutes只支持整数。"
  }
}

📋 配置选项说明

选项	类型	默认值	描述
`interval_minutes`	整数	10	自动公告间隔时间
`use_&_color`	布尔值	true	是否支持 `&` 颜色代码
`language`	字符串	"en_us"	模组语言
`announcements`	对象	{}	公告名称和消息

🎨 颜色代码支持

📌 标准 Minecraft 代码: 使用 § 加颜色/格式代码（如 §a 表示绿色）
🔄 替代格式: 当 use_&_color 为 true 时，可使用 & 代替 §（如 &a 表示绿色）
🔒 转义: 当 use_&_color 为 true 时，要显示文本 &，请使用 &&
📄 换行: 在消息中使用 \n 来换行

🌐 支持的语言

模组目前支持：

English (en_us)
简体中文 (zh_cn)

如果你想加入自己的语言，请在 Github 上提交 PR。

📦 安装方法

确保你的服务端为 Fabric
下载模组 JAR 文件
放入服务器的 mods 文件夹
重启服务器
使用指令或编辑配置文件来配置公告

📖 使用示例

# 启用公告并设置 15 分钟间隔
/ats-announce status enable
/ats-announce interval 15

# 添加彩色欢迎消息
/ats-announce addwithname "欢迎" "&6欢迎！&a祝你玩得开心！"

# 添加规则提示
/ats-announce add "§c规则：\n§7输入 /rules 获取更多信息"

# 立即发送特定公告
/ats-announce send 欢迎

❓ 常见问题

Q: 如何设置多行公告？

A: 在公告消息中使用 \n 来换行。

Q: 颜色代码不生效怎么办？

A: 检查配置文件中的 use_&_color 设置，确保使用正确的颜色代码格式。

Q: 如何临时停止公告？

A: 使用 /ats-announce status disable 来禁用自动公告。

Q: 配置文件在哪里？

A: 配置文件位于服务器根目录的 config/ats-announce.json。

Q: 加入后提示 Fabric Loader 版本过低（<0.16.14）

A: 有两个方法：

更新你的 Fabric Loader 到最新版本。
使用压缩软件打开模组 JAR 文件，找到 fabric.mod.json 文件，修改 depends -> fabricloader 字段的 0.16.14 为你的 Fabric Loader 版本。

出现这个问题的原因是模组编译时用的 Fabric Loader 版本较高，不过因为模组功能较少，模组大概率并不依赖于特定的 Fabric Loader，所以你可以尝试通过修改 fabric.mod.json 来兼容旧版本。但是如果你遇到其他问题，建议还是更新 Fabric Loader，除非你有特殊需求需要使用旧版本。

Q: 如何添加自己的语言？如何修改默认的提示文字？

A: 在模组的 lang 文件夹中直接添加或修改语言文件即可，文件格式为 <语言代码>.json。添加新语言后需要在同目录下的 languages.txt 中添加你的语言文件名，最后在配置文件中设置 language 为你的语言代码即可。欢迎在 GitHub 通过 PR 提交你的语言文件！

AtsAnnounce

Compatibility

Minecraft: Java Edition

Platforms

Supported environments

Links

Tags

Creators

Details

📢 AtsAnnounce

✨ Features

💻 Command Reference

📊 Status Management

⚙️ Configuration Management

📝 Announcement Management

🚀 Manual Broadcasting

📁 Configuration File

📋 Configuration Options

🎨 Color Code Support

🌐 Supported Languages

📦 Installation

📖 Usage Examples

❓ Frequently Asked Questions

📢 AtsAnnounce

✨ 支持的功能

💻 指令解释

📊 状态管理

⚙️ 配置管理

📝 公告管理

🚀 手动发送

📁 配置文件

📋 配置选项说明

🎨 颜色代码支持

🌐 支持的语言

📦 安装方法

📖 使用示例

❓ 常见问题