状态修改器

状态修改器

使用YAML创建强大的Minecraft事件。无需编程。兼容ConditionalEvents的优化替代方案。

基础库

ConditionsMod

ConditionsMod 是一个 Minecraft 模组,让你使用简单的 YAML 文件创建完全可自定义的事件,无需编写代码。

它受 ConditionalEvents 启发,但以更强大的目标构建:为现代模组服务器提供更简洁、更快速、更轻量、更灵活的事件系统。ConditionsMod 保留了熟悉的事件-条件-动作工作流,同时改进了配置体验、运行时性能和可扩展性。

该项目根据 Minecraft 版本设计为 Forge 和 Fabric 移植版。

工作原理

ConditionsMod 遵循简单的流程:

Event -> Conditions -> Actions

  • Event:检测游戏中发生的事情。
  • Conditions:检查是否满足要求。
  • Actions:如果条件通过则执行结果。

这让你无需创建单独的模组或编写 Java 代码即可构建自定义服务器行为。

YAML 配置

事件通过 .yml 文件配置。

Server: conditions/
Client: config/conditions/

示例:

events:
  - name: welcome
    type: player_join
    enabled: true
    conditions: []
    actions:
      default:
        - "message: &aWelcome, %player%!"

ConditionalEvents 兼容性

ConditionsMod 支持 ConditionalEvents 风格的配置,因此服务器所有者可以迁移许多现有设置而无需重写所有内容。

支持的兼容特性包括:

  • Events: 根节点。
  • 原生 events: 列表格式。
  • 文本条件,例如 %main_command% == /hello。
  • 使用 execute 的条件动作分支。
  • 使用 and 和 or 的复合条件。
  • 动作组,例如 default、cooldown、one_time 和自定义组。
  • 定向动作,例如 to_all、to_target、to_world、to_player 和 to_range。
  • 常见变量,例如 %player%、%main_command%、%args_length%、%arg_1%、%block%、%playerblock_inside%、%playerblock_below_1%、%playerblock_above_1%、%random_1_10%、%random_last%、%world_time%、冷却变量和 SVR 变量。

使用 ConditionalEvents 风格布局的示例:

Events:
  command_example:
    type: player_command
    conditions:
      - "%main_command% == /announce"
      - "%args_length% == 0 execute error"
    actions:
      default:
        - "to_all: centered_message: &c&lAnnouncement"
        - "to_all: message: &e%player%&7: %args_substring_1-100%"
      error:
        - "message: &cUse /announce <message>"

ConditionsMod 改进之处

ConditionsMod 旨在超越传统的 ConditionalEvents 方法:

  • YAML 优先的配置,更易于阅读和维护。
  • 轻量级运行时,专注于仅检查所需内容。
  • 按名称快速查找事件,用于调用、启用/禁用命令和调试工具。
  • 事件按类型分组,减少不必要的检查。
  • 缓存正则条件,提升重复条件性能。
  • 并发运行时状态,用于冷却和一次性事件跟踪。
  • 更简洁的附加 API,用于自定义动作、占位符、变量和自定义事件。
  • 传统仅服务器插件无法提供的客户端功能,例如 HUD、摄像机、按键阻止和按键组合。
  • 更简单的核心,避免在不需要时加载大型插件式系统。

事件类型

ConditionsMod 包含以下事件类型:

  • 玩家加入、离开、死亡、击杀、聊天、命令、重生、传送、伤害、潜行、跳跃、物品栏、统计、饥饿、氧气等。
  • 方块破坏、放置和交互。
  • 物品交互、消耗、拾取、丢弃、合成、附魔、修复、移动和选择。
  • 实体交互和生成。
  • 服务器启动、停止、重复服务器检查、自定义事件和调用事件。
  • 客户端功能,例如 HUD 显示、摄像机、按键和按键组合事件。

条件

条件支持常见运算符:

==, !=, equals, !equals
equalsIgnoreCase, !equalsIgnoreCase
contains, !contains
startsWith, !startsWith
endsWith, !endsWith
matches, !matches
>, >=, <, <=

示例:

conditions:
  - "%player_world% == overworld"
  - "%main_command% equalsIgnoreCase /spawn"
  - "%args_length% == 0 execute no_args"
  - "%block% matches (?i)(minecraft:)?stone_button"

动作

可用动作包括:

  • message
  • centered_message
  • broadcast
  • title
  • actionbar
  • console_command
  • player_command
  • kick
  • cancel_event
  • give_item
  • remove_item
  • give_potion_effect
  • remove_potion_effect
  • heal
  • damage
  • set_food_level
  • set_on_fire
  • gamemode
  • playsound
  • particle
  • lightning_strike
  • set_block
  • summon
  • teleport
  • set_cooldown
  • call_event
  • wait
  • to_all
  • to_target
  • to_world
  • to_player
  • to_range

特殊功能

摄像机

摄像机事件可以更改玩家摄像机模式或视角,实现 2D 视图、RPG 风格视图和自定义摄像机位置等效果。

HUD

HUD 事件可以显示自定义屏幕文本,包含位置、缩放、背景、持续时间和动画。

按键和按键组合

按键事件可以通过配置阻止或控制特定按键、鼠标按钮或按键组合。

SVR 变量

SVR 提供持久化服务器变量,用于全局值、玩家值和列表,以 YAML 存储。

自定义事件

其他模组可以向 ConditionsMod 触发自定义事件,让配置对外部模组逻辑作出反应。

项目状态

ConditionsMod 正在积极开发中。兼容层将继续扩展,增加更多 ConditionalEvents 风格的变量、动作和等效事件。

目标不是成为简单的克隆。目标是保留轻松的事件配置风格,同时提供更好的性能、更清晰的结构、更强的模组集成以及传统仅服务器插件无法实现的功能。


ConditionsMod Español

ConditionsMod 是一个 Minecraft 模组,允许你使用 YAML 文件创建完全自定义的事件,无需编程。

它受 ConditionalEvents 启发,但旨在更进一步:为现代模组服务器提供更简洁、快速、轻量和灵活的系统。它保留了易于理解的事件-条件-动作理念,但具有更好的组织、更好的性能和更多扩展可能性。

该项目根据 Minecraft 版本计划提供 Forge 和 Fabric 移植版。

工作原理

ConditionsMod 使用以下流程:

Evento -> Condiciones -> Acciones

  • Evento:检测游戏中发生的事情。
  • Condiciones:检查是否满足要求。
  • Acciones:当条件通过时执行响应。

有了这个,你无需制作另一个模组,也无需编写 Java 代码,即可创建完整的系统。

YAML 配置

事件通过 .yml 文件配置。

Servidor: conditions/
Cliente: config/conditions/

示例:

events:
  - name: bienvenida
    type: player_join
    enabled: true
    conditions: []
    actions:
      default:
        - "message: &aBienvenido, %player%!"

与 ConditionalEvents 的兼容性

ConditionsMod 支持 ConditionalEvents 的配置风格,因此用户可以迁移许多配置,而无需从头重做所有内容。

包含的兼容性:

  • Events: 根节点。
  • 原生 events: 格式。
  • 文本条件,例如 %main_command% == /hello。
  • 使用 execute 的条件分支。
  • 使用 and 和 or 的复合条件。
  • 动作组,例如 default、cooldown、one_time 和自定义组。
  • 定向动作,例如 to_all、to_target、to_world、to_player 和 to_range。
  • 常见变量,例如 %player%、%main_command%、%args_length%、%arg_1%、%block%、%playerblock_inside%、%playerblock_below_1%、%playerblock_above_1%、%random_1_10%、%random_last%、%world_time%、冷却变量和 SVR 变量。

使用 ConditionalEvents 风格格式的示例:

Events:
  comando_anuncio:
    type: player_command
    conditions:
      - "%main_command% == /anuncio"
      - "%args_length% == 0 execute error"
    actions:
      default:
        - "to_all: centered_message: &c&lAnuncio"
        - "to_all: message: &e%player%&7: %args_substring_1-100%"
      error:
        - "message: &cUsa /anuncio <mensaje>"

ConditionsMod 改进了什么

ConditionsMod 旨在改善经典 ConditionalEvents 方法的体验:

  • 更清晰、更易于编辑的 YAML 配置。
  • 更轻量的系统,旨在仅执行必要内容。
  • 按名称快速查找事件,用于 call_event、启用/禁用命令和调试。
  • 事件按类型分组,以减少不必要的检查。
  • 缓存正则,以改善重复条件。
  • 并发的运行时状态,用于冷却和一次性事件。
  • 更简洁的附加 API,用于自定义动作、占位符、变量和自定义事件。
  • 仅服务器插件无法提供的客户端功能,例如 HUD、摄像机、按键阻止和按键组合。
  • 更简单的核心,避免在不需要时加载大型系统。

事件类型

ConditionsMod 包含以下事件:

  • 玩家:进入、离开、死亡、击杀、聊天、命令、重生、传送、伤害、潜行、跳跃、物品栏、统计、饥饿、氧气等。
  • 方块:破坏、放置和交互。
  • 物品:交互、消耗、拾取、丢弃、合成、附魔、修复、移动和选择。
  • 实体:交互和生成。
  • 服务器:启动、关闭、重复服务器事件、自定义事件和调用事件。
  • 客户端:HUD、摄像机、按键和按键组合。

条件

条件支持常见运算符:

==, !=, equals, !equals
equalsIgnoreCase, !equalsIgnoreCase
contains, !contains
startsWith, !startsWith
endsWith, !endsWith
matches, !matches
>, >=, <, <=

示例:

conditions:
  - "%player_world% == overworld"
  - "%main_command% equalsIgnoreCase /spawn"
  - "%args_length% == 0 execute sin_argumentos"
  - "%block% matches (?i)(minecraft:)?stone_button"

动作

可用动作:

  • message
  • centered_message
  • broadcast
  • title
  • actionbar
  • console_command
  • player_command
  • kick
  • cancel_event
  • give_item
  • remove_item
  • give_potion_effect
  • remove_potion_effect
  • heal
  • damage
  • set_food_level
  • set_on_fire
  • gamemode
  • playsound
  • particle
  • lightning_strike
  • set_block
  • summon
  • teleport
  • set_cooldown
  • call_event
  • wait
  • to_all
  • to_target
  • to_world
  • to_player
  • to_range

特殊功能

Camera

摄像机事件允许更改玩家视角或透视,例如 2D 摄像机、RPG 视图或自定义位置。

HUD

HUD 事件允许在屏幕上显示文本,包含位置、缩放、背景、持续时间和动画。

Key 和 Key Combo

按键事件允许通过配置阻止或控制按键、鼠标按钮或完整组合。

SVR 变量

SVR 允许使用 YAML 保存持久的全局变量、按玩家变量和列表。

自定义事件

其他模组可以向 ConditionsMod 触发自定义事件,让配置对外部系统作出反应。

项目状态

ConditionsMod 正在积极开发中。与 ConditionalEvents 的兼容性将继续增长,增加更多等效变量、动作和事件。

目标不是成为简单的副本。目标是保留无需编程创建事件的简便性,同时具有更好的性能、更清晰的结构、更好的模组集成以及传统仅服务器插件无法实现的功能。