查看“AutoMessage”的源代码

[[Category:聊天]]
[[Category:信息]]
==综述==
===介绍===
  AutoMessage是一个易于使用的聊天栏公告插件。
  这个插件非常适合那些想要将一些设定的信息以广播形式发布的服务器管理员们。
  这个插件的特性在于，你可以在游戏中使用命令编辑一切可以在配置文件中修改的配置项。
  这是一个轻量级的插件，并不会影响服务器的性能。
  AutoMessages会自动检测更新以确保插件处于最新版本。

===特性===
  完全可自定义的配置系统!
  游戏中功能多样的配置编辑器!
  快速无损的重载机制.
  可选的随机公告.
  支持颜色代码.
  在信息中运行命令.

===安装===
  将jar文件拖入plugins文件夹并重启服务端即可.

==常见问题及解答==
Q:为什么我使用"/am add 公告"添加了一个叫"公告"的组后，显示的信息十分杂乱？

A:新的分组后会内置一些默认的公告内容，只需连续执行命令"/am remove 公告 0"删除公告组内序号为0的公告内容连续5次即可删除默认信息。

Q：为什么玩家看不见公告？

A：你需要把权限节点：automessage.receive.default添加进玩家组里面，default为默认组，详细请看下面的权限一栏。

==权限==
AutoMessage 使用权限来允许用户和组来执行特定的指令。你可以使用例如PermissionsEx or bPermissions等权限管理插件来管理这些权限。在下方你将会找到个列表来查看权限。

automessage.commands.reload: 

重新载入配置文件的权限

automessage.commands.update: 

当插件不是最新版本时，升级插件的权限。

automessage.commands.add: 

创建一个公告列表，或者添加消息到现有的公告列表。

automessage.commands.edit: 

编辑一条现有的公告 

automessage.commands.remove: 

删除一个公告列表，或者从一个现有的公告列表中删除一条公告

automessage.commands.enabled: 

切换到一个指定的公告列表，这个公告列表会始终可以编辑，但是在这段期间，这个列表内的公告将不会被播出。

automessage.commands.interval: 

设置公告列表内的时间间隔

automessage.commands.random: 

设置一个列表的播出顺序，例如:随机播放

automessage.commands.prefix: 

设置公告的前缀

automessage.commands.suffix: 

设置公告的后缀

automessage.commands.broadcast: 

从一个特定的列表中广播一条消息

automessage.commands.list: 

列出所有的公告列表或列出指定一个公告列表的所有公告 ；查看所有公告

automessage.receive.message-list: 

Receive broadcasts from a list. Replace message-list with the name of the message list in your config. ；接收来自某列表的公告

==命令==
==配置==
Config:
settings:
  enabled: true                       ；是否启用 true为是，false为否(下面也是这样)
  min-players: 5                         ；最小听见广播的玩家数量？我的理解应该是当有这个数值的玩家或以上在线时才开始播放这个公告
  log-to-console: true                     ；是否显示在控制台
message-lists:                            ；公告列表      
  regular:                                 ；公告列表的名字
    enabled: true                          ；是否启用
    random: false                          ；是否随机
    interval: 45                           ；间隔时间
    expiry: -1                                ；到期时间(-1为不会到期
    messages:                                 ；公告内容
    - '&1First&r message \nin the default list!'
    - '&2Second&r message \nin the default list!'
    - '&3Third&r message \nin the default list!'
    - 'These messages will be displayed to users with \nautomessage.receive.default!'
  json:                                   ；又是一个公告列表的名字    下面的内容和上面的一样
    enabled: true
    random: false
    interval: 45
    expiry: -1
    messages:
    - '{text:"Hover over me!",hoverEvent:{action:show_text,value:[{text:"Woah, you just hovered over me!",color:blue}]}}'
    - '{text:"Click me to run a command!",clickEvent:{action:run_command,value:"/say Clicked."}}'
    - '{text:"Click me to open Google!",clickEvent:{action:open_url,value:"http://google.com"}}'

==其他==
'''代码:'''<br />
配设文件内可以添加变量，颜色以及指令等. 如果你的信息前面加入 / 系统会默认为是一条指令. 如果你编辑时想换行请输入 \n. 颜色代码可以随时加入. 同时也可以添加变量. 这些设定会美化你的信息/公告。<br />
<br />

'''变量列表'''
{| class="wikitable"
|-
! 变量 !! 列子 !! 效果
|-
| {NAME} || Hey {NAME} || Hey ELCHILEN0!
ELCHILEN0是原作者ID
|-
| {DISPLAYNAME} || Hey {DISPLAYNAME}! || Hey ELCHILEN0!
|-
| {WORLD} || 你在{WORLD}! || 你在XX世界!
|-
| {BIOME} || 你在{BIOME}生物群系! || 你在XX生物群系!
|-
| {ONLINE} || 目前有{ONLINE}玩家在线! || 目前有XX玩家在线!
|-
| {MAX_ONLINE} || 服务器最大人数{MAX_ONLINE}! || 服务器最大人数XX!
|-
| {YEAR} || 今年是{YEAR}年! || 今年是XX年!
|-
| {MONTH} || 现在是{MONTH}月! || 现在是XX月!
|-
| {WEEK_OF_MONTH} || 本月第{WEEK_OF_MONTH}个星期! || 本月第XX个星期!
|-
| {WEEK_OF_YEAR} || 今年第{WEEK_OF_YEAR}个星期! || 今年第XX个星期!
|-
| {DAY_OF_WEEK} || 这个星期已经过了{DAY_OF_WEEK}天! || 这个星期已经过了XX天! 
|-
| {DAY_OF_MONTH} || 这个月已经过了{DAY_OF_MONTH}天! || 这个月已经过了XX天! 
|-
| {DAY_OF_YEAR} || 今年已经过了{DAY_OF_MONTH}天!  || 今年已经过了XX天!
|-
| {HOUR} || 现在是{HOUR}点 || 现在是XX点
|-
| {HOUR_OF_DAY} || It is {HOUR_OF_DAY} hundred hours! || It is XX hundred hours!
|-
| {MINUTE} || 已经过了{MINUTE}分钟! || 已经过了XX分钟!
|-
| {SECOND} || 已经过了{MINUTE}秒! || 已经过了XX秒!
|-
|}
<br />
'''颜色代码'''<br />

==GitHub Repo==
==Scheduled Messages Ideas==