THINK TWICE BEFORE UPGRADING BECAUSE CONFIG AND JSON FORMAT ARE REFACTORED IN THIS VERSION.

If upgraded from 0.1.2-alpha or older version or encountering the issue that neutral mobs don't become alert, delete all folders and files in directory config/stealth_and_alert/entities or enter the command /stealth_and_alert config force_regenerate_and_reload. Besides, delete this mod's old config files.

升级前请三思，因为 Config 和 JSON 格式在此版本已经被重构。

如果从 0.1.2-alpha 或更旧的版本升级上来，或遇到中立生物不产生警戒的问题，删除 config/stealth_and_alert/entities 目录下所有文件夹和文件，或者输入命令 /stealth_and_alert config force_regenerate_and_reload。此外，删除本模组旧的 Config 文件。

English

General

• Added Assassination Base Multiplier component, which can bring weapons additional assassination damage bypassing armors, shields, and effects when attacking enemies. For most weapons, the multiplier is 0 by default. Additional assassination damage is applied only when Attack Recharge Bar is full.
• Added Vital Pierce enchantment, which can increase assassination damage multiplier of a weapon, 0.2 per level.
• Made a change to Visibility which now is stored and used as entity attribute rather than data attachment, and added Sound Multiplier attribute.
• Added Ethereal effect and potions, able to decrease players' visibility and sound multiplier.
• Added world gen for Shadow Crystal Ore and Deepslate Shadow Crystal Ore.
• Decreased Shadow Crystal material's base destroying speed, to make it between iron and diamond.
• Shadow Crystal Dagger has 0.3 Assassination Base Multiplier component; besides, it cannot perform sweeping attacks now.

Detection & Alert

• Added block tag SEE_THROUGHS. Blocks in it can be seen through by enemies now so players cannot hide behind these blocks. e.g., Glass Block, Iron Bars, and Chain.
• Enderman, when investigating an LKP, can teleport now.
• Optimised enemies' investigating LKP.
• Optimised enemies' behaviours when attacked.
• For enemies, decreased duration of entering FIGHTING state and increased duration of tracking players when losing sight of them.
• Adjusted the influence from distance and visibility on awareness increase rate.

Config & Data-driven

• Refactored config TOML files' format.
• Added in-game config screen.
• Added translation keys for in-game config screen; TOML files' comments are written only in English now.
• Added Assassination Always Success and Success Chance config settings.
• Added Assassinate Pets config settings.
• Refactored JSON format for entities' detection, assassination and alert conditions settings. Instructions will be published then.
• Added several fields in JSON to more precisely control different entities' behaviours.
• Optimised alert conditions and their implementations.
• Added entity tag "PROTECTED" for an alert condition. Mobs in it can have memory ticks toward a player attacking them, but not causing alert. e.g., Villagers.
• Removed Panda from default CONDITIONAL_SEEKERS tag.

Others

• Added commands /stealth_and_alert config reload/regenerate_and_reload/force_regenerate_and_reload to reload configurations of entities in JSON. regenerate means copying entity JSON presets files from resources/data/stealth_and_alert/presets/entities/<namespace>/<entity id>.json to config/stealth_and_alert/entities/<namespace>/<entity id>.json. In short, regenerating entity JSON presets files.
• If a mob is ridden by another mob, only the passenger can be assassinated now, and the vehicle cannot move either during assassination.
• Made changes to textures of Shadow Crystal, Shadow Crystal Shard and Shadow Crystal Dagger.
• Improved an animation of daggers.

Bugfixes

• Fixed an issue that enemies' cannot patrol around LKP.
• Fixed a potential data overflow issue when applying to assassination damage.
• And others.

中文

一般

• 新增了刺杀伤害倍率（Assassination Base Multiplier）物品组件，当用武器攻击敌人时，附带刺杀伤害类型，无视护甲、盾牌和药水效果等，对于大多数武器，默认倍率为 0。刺杀伤害仅在攻击蓄力条满时才能被打出。
• 新增了“贯命”（Vital Pierce）附魔，能提升武器的刺杀伤害倍率，每级提升 0.2。
• 对可见度数据做了修改，现在可见度是作为 attribute 而非 data attachment；同时，新增了声音系数（Sound Multiplier）的 attribute。
• 新增了“幽虚”（Ethereal）药水效果，能降低玩家的可见度和声音系数。
• 新增了“暗影水晶矿石”和“深层暗影水晶矿石”的世界生成。
• 降低了暗影水晶材料的基础挖掘速率，以使之处在铁和钻石之间。
• “暗影水晶匕首”现自带 0.3 刺杀伤害倍率；此外，它已无法施展横扫攻击。

侦测 & 警戒

• 新增了方块标签 SEE_THROUGHS，这些方块可以被敌人的视线穿透，所以玩家将不再能在这些方块后躲避。例如，玻璃、铁栏杆和锁链。
• 末影人在调查 LKP 时可以使用传送能力。
• 优化了敌人调查 LKP 时的 AI。
• 优化了敌人受击后的行为。
• 减少敌人进入战斗状态的过渡时间，增加敌人丢失视野后对玩家的追踪时间。
• 调整了距离和可见度对警戒值上涨速率的影响。

配置 & 数据驱动

• 重构了 TOML 配置文件的格式。
• 新增了游戏内配置界面。
• 为游戏内配置界面添加了翻译键和本地文本；TOML 文件内的注释则仅写以英文。
• 新增刺杀必定成功和成功率的配置项。
• 新增刺杀宠物的配置项。
• 重构了 JSON 文件格式，有关于实体的侦测、刺杀和警戒条件的设置。相关指南将会在之后发布。
• 在 JSON 中新增了一些字段，以更精确地控制不同生物的行为。
• 优化了警戒条件和及其实现。
• 新增实体标签 PROTECTED，以配合警戒条件使用。标签内生物可以对攻击它们的玩家产生仇恨记忆，但不会触发警戒。例如，村民。
• 将熊猫移出 CONDITIONAL_SEEKERS 标签默认值。

其他

• 新增了命令 /stealth_and_alert config reload/regenerate_and_reload/force_regenerate_and_reload，用于重载 JSON 中的实体配置。regenerate 意思是将 resources/data/stealth_and_alert/presets/entities/<命名空间>/<实体 ID>.json 文件，复制到 config/stealth_and_alert/entities/<命名空间>/<实体 ID>.json。一句话，重新生成预设 JSON 文件。
• 如果一个生物骑着另一个生物，玩家只能刺杀最上面的生物，且刺杀过程中坐骑生物也会被限制行动。
• 修改了“暗影水晶”“暗影水晶碎片”和“暗影水晶匕首”的贴图。
• 优化了匕首的一个刺杀动画。

Bug 修复

• 修复了敌人无法在 LKP 附近巡逻的问题。
• 修复了施加刺杀伤害时潜在的数据溢出问题。
• 以及其他。