AcuteLoot - 自定义战利品与效果

简介

AcuteLoot 为 Minecraft 服务器添加了高度可定制的 RPG 风格战利品系统，拥有超过 150 亿种独特可能性。你可以通过附魔台、击杀生物、钓鱼获取稀有宝藏或在自然生成的箱子中发现 AcuteLoot。

💡主要特性

• 自定义名称生成器：完全控制名称生成方式，轻松创造数万亿种可能的名称。
• 自定义稀有度：调整稀有度的名称和概率，并创建属于你自己的稀有度。
• 自定义战利品来源：控制战利品如何以及何时通过附魔、钓鱼、生物、箱子等方式产生！
• 支持所有语言：可配置的聊天和 GUI 消息。
• 特殊效果：为剑、弓等武器提供超过 15 种特效。

- 使用 **美杜莎** 效果将敌人变成石头。

- 使用 **时间行者** 效果拖动太阳前进/后退。

- 使用 **死亡之眼** 效果减缓时间并快速发射弓箭。

• 易于使用：拖放即可安装。权限系统为可选！
• 轻量高效：经过编写和测试，确保快速且可扩展。
• 可扩展性：提供详细的 API 文档，方便你创建自己的效果并将插件接入数十亿的名称库。
• 完全免费：零成本下载和使用。

🎮安装与使用

安装

• 将 .jar 文件拖放至服务器的 /plugins 文件夹，然后重启服务器。

如何使用

• 附魔任何物品即可生成 AcuteLoot。生成的 AcuteLoot 将拥有自定义名称、稀有度，甚至可能在使用时触发特殊效果。
• AcuteLoot 也可以通过钓鱼、击杀生物以及打开自然生成的箱子（如地牢中的箱子）获得。

兼容性

• 官方测试支持 1.15 至 1.18 版本。
• 理论上兼容 1.12+ 版本，但需要你配置 materials.txt 列表，仅包含与你服务器版本兼容的材料。

🔧配置指南

• 查看 config.yml 以调整各种设置和选项。几乎所有内容都可自定义，从不同稀有度的概率到名称生成器的特性。
• 要创建自定义名称，请编辑 /names 文件夹中的 .txt 文件。

- `/names/fixed` 文件夹中的 `.txt` 文件包含静态名称，将完全按照你输入的样子显示。

• 要添加或移除随机战利品生成中包含的物品，请修改 materials.txt 文件。
• 使用 /al reload 命令可重新加载所有配置选项和 .txt 文件。

✨效果展示

弓类粒子效果

• Linger
• Lava
• Sparkle
• Cursed
• Love
• 治疗效果：治疗目标，数值等于箭矢伤害！

工具类粒子效果

• Laser
• Lava
• Loopy
• Music
• Splash
• Sticky
• Mythic

特殊装备效果

• 园丁靴：行走时脚下会种植花朵！
• 时间行者靴：拖动太阳跨越天空，并使生物和作物加速生长！
• 死亡之眼弓：减缓时间并快速连射箭矢。灵感来源于《荒野大镖客》。
• 末影弓：会把你射出去的弓！
• 美杜莎弓：将敌人变成石头！
• 经验提升头盔：增加所有活动获得的经验值！

⭐权限列表

权限完全可选，但默认启用以便于配置。默认情况下，只有 OP 可以使用 AcuteLoot 命令，但所有玩家都可以通过附魔、钓鱼或打开自然生成的箱子获得 AcuteLoot。

• acuteloot.new
• acuteloot.rename
• acuteloot.remove
• acuteloot.stats
• acuteloot.reload
• acuteloot.help
• acuteloot.add
• acuteloot.name
• acuteloot.chest
• acuteloot.salvage
• acuteloot.salvage-force-open
• acuteloot.* (所有 AcuteLoot 权限)
• acuteloot.enchant (允许使用附魔台创建 AcuteLoot。默认所有人可用)
• acuteloot.reroll (默认所有人可用)
• acuteloot.give

🎮命令列表

• /al new [rarity] [effect] - 生成完全随机的战利品。
• /al rename [name] - 为重命名手持物品。留空则恢复为默认名称。
• /al remove - 移除物品上的 AcuteLoot 属性（名称、稀有度、特殊效果）。
• /al stats - 手持物品时显示其 LootCode（更多功能即将推出）；未手持物品时显示总体统计信息。
• /al reload - 重新加载配置、名称文件和战利品材料列表。
• /al help - 打印帮助信息和命令菜单。
• /al add <rarity> [effect] - 为物品添加指定的稀有度和效果。
• /al give <player> [rarity] [effect] - 给予目标玩家 AcuteLoot 物品。
• /al name [generator] - 为物品生成一个 AcuteLoot 名称。
• /al chest [minutes] [radius] [overwrite]

- 创建 AcuteLoot 箱子。如果你的准星指向一个箱子，则只影响该箱子；否则，将搜索你所在的区块并影响其中的所有箱子。

- 指定 `radius` 参数将影响附近区块内的所有箱子，最大半径为 8。

- 可选的 `minutes` 参数指定箱子重新填充战利品前的冷却时间。

- 当 `overwrite` 布尔值为 true 时，将覆盖现有的 AcuteLoot 箱子。

- 注意：目前通过此命令创建的箱子遵循 `config.yml` 中的全局箱子概率，因此设置冷却时间并不保证箱子一定会刷新战利品。

• /al rmchest [radius] - 移除指定区块半径内附近箱子的 AcuteLoot 元数据。
• /al reroll - 以可配置的价格，重新随机生成 AcuteLoot 的稀有度、名称和效果。
• /al salvage [player]

- 打开一个 GUI，将 AcuteLoot 分解为其他物品或执行任何命令。许多选项可在 `config.yml` 中配置。

[BETA] 命令

• 这些命令正在积极开发中。请在 GitHub 上报告任何问题。

❓常见问题

名称是如何生成的？

AcuteLoot 使用一种简单的算法来生成随机战利品名称，该算法将前缀和后缀组合在一起，创造出有趣、新颖且常常幽默的名字。默认包含的前缀和后缀来源广泛，包括常见的英语形容词、副词、名词，以及来自世界各地的神话传说生物/怪物名称。

你可以增加、删除这些名称池，或创建全新的名称池。想象一下，基于你最喜欢的流行文化引用或服务器内部笑话来创建战利品的可能性！

算法使用可配置的模式来定义名称生成器。默认包含五种生成器模式。生成器模式是名称池标签和其他文本（通常是空格和连词）的组合。

• prefixGenerator

- 模式：`"[prefix] [item_name]"`

• suffixGenerator

- 模式：`"[item_name] of [suffix]"`

• prefixSuffixGenerator

- 模式：`"[prefix] [item_name] of [suffix]"`

• fixedGenerator

- 模式：`"[fixed]"`

• kanaGenerator

- 模式：`"[kana](2-5)"`

每种物品类型显示的名称也可以自定义。例如，剑可以被命名为任何你想要的名称，如“小刀”、“刺刺者”或“尖尖的物体”。

你也可以使用静态（固定）名称，以实现最大程度的自定义。这些是你完全自己创建的全名，不会对它们进行任何添加或删除。请注意，它们会像生成器产生的名称一样被添加到可能的名称池中，因此如果你有很多可能的名称，固定名称可能会相当稀有。默认情况下，这些列表大多是空的。你可以在 /names/fixed 文件夹中添加自己的名称。generic.txt 用于 materials.txt 文件中列出的物品，并在生成完全随机战利品时使用。

最后，还有一种称为“假名生成器”的模式，它通过组合片假名音节来创造听起来像日语的名称。仅此生成器就能产生超过 30 亿个独特名称。如果你不希望出现这些名称，可以在配置中禁用此生成器。

有关名称生成器的更详细信息，请参阅 config.yml。最新版本可在此处获取。

稀有度和效果的几率是如何运作的？

稀有度和效果的几率以相对整数值表示。例如，如果你有三个稀有度，每个的几率都是“5”，那么每个稀有度被选中的几率是 5/15 = 1/3。如果你有一个稀有度几率为“5”，一个为“10”，一个为“15”，那么第一个稀有度的几率是 5/30 = 1/6，第二个是 10/30 = 1/3，第三个是 15/30 = 1/2。如果几率总和恰好为 100，则可以将其视为简单的百分比值。

由于生成器的工作方式，稀有度需要按几率降序列出（例如，从普通到稀有）。请注意，单个效果的几率是相对于适用于该物品类型的其他效果而言的。

注意：对于简单的二元事件（如从箱子或钓鱼中获得 AcuteLoot），其几率是简单、可预测的百分比，不使用相对整数值方法。

铁砧如何运作？

铁砧的行为仅被修改为允许在使用铁砧时保留 AcuteLoot 的彩色物品名称。左侧的物品优先于右侧的物品，因此其名称、稀有度和效果将保留在新物品中。名称、稀有度或效果不会叠加。

🔧支持与功能请求

• 要报告错误或建议新功能，请在 GitHub 上提交问题。

- 对于错误报告，请使用 **bug** 问题标签。

- 对于功能建议，请使用 **enhancement** 问题标签。

• 为了使功能建议被考虑用于未来开发，请尽可能提供详细信息：

- 新功能的详细描述、使用方式以及涉及 AcuteLoot 的哪些部分（名称、效果、稀有度等）。

- 提议的 `config.yml` 选项的详细大纲。请尽可能精确地描述功能的配置格式。

• 如果你没有 GitHub 账户，可以加入我们的 Discord 来讨论、建议功能和报告错误。

注意：AcuteLoot 的目标是每月初左右发布更新。计划在下一个版本中推出的功能会在上述链接中，标记为 in progress 的问题标签下发布。我们会考虑所有合理建议的功能，但无法满足所有请求。通过在请求中包含详细信息并及时回答开发人员的任何问题，你可以大大增加你的功能被纳入未来版本的机会。

✨支持我们

如果你喜欢这个插件，可以考虑通过以下方式支持开发：

• PayPal: https://paypal.me/zizmax
• BTC: bc1q5mqsfawg2ns2ycy3gf6gnhqa8rzt0rdd7ga50p
• ETH: 0xE31fc7241886b37b545a4141E5641A1c6972671E

请注意：请不要在评论部分报告问题。我无法通过评论部分提供技术支持。