ConditionMod

# ConditionsMod ConditionsMod is a Minecraft mod that lets you create fully customizable events using simple YAML files, without writing code. It is inspired by ConditionalEvents, but it is built with a stronger goal: to provide a cleaner, faster, lighter, and more flexible event system for modern modded servers. ConditionsMod keeps the familiar event-condition-action workflow while improving the configuration experience, runtime performance, and extensibility. The project is designed for Forge and Fabric ports, depending on the Minecraft version. ## How It Works ConditionsMod follows a simple flow: `Event -> Conditions -> Actions` - `Event`: detects something happening in the game. - `Conditions`: checks whether requirements are met. - `Actions`: runs the result if the conditions pass. This lets you build custom server behavior without creating a separate mod or writing Java code. ## YAML Configuration Events are configured with `.yml` files. ```text Server: conditions/ Client: config/conditions/ ``` Example: ```yaml events: - name: welcome type: player_join enabled: true conditions: actions: default: - "message: &aWelcome, %player%!" ``` ## ConditionalEvents Compatibility ConditionsMod supports ConditionalEvents-style configuration so server owners can migrate many existing setups without rewriting everything. Supported compatibility features include: - `Events:` root section. - Native `events:` list format. - Text conditions such as `%main_command% == /hello`. - Conditional action branches with `execute`. - Compound conditions with `and` and `or`. - Action groups such as `default`, `cooldown`, `one_time`, and custom groups. - Targeted actions such as `to_all`, `to_target`, `to_world`, `to_player`, and `to_range`. - Common variables such as `%player%`, `%main_command%`, `%args_length%`, `%arg_1%`, `%block%`, `%playerblock_inside%`, `%playerblock_below_1%`, `%playerblock_above_1%`, `%random_1_10%`, `%random_last%`, `%world_time%`, cooldown variables, and SVR variables. Example using ConditionalEvents-style layout: ```yaml 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>" ``` ## What ConditionsMod Improves ConditionsMod is made to go beyond the traditional ConditionalEvents approach: - YAML-first configuration that is easier to read and maintain. - Lightweight runtime focused on checking only what is needed. - Fast event lookup by name for calls, enable/disable commands, and debug tools. - Events grouped by type, reducing unnecessary checks. - Cached regex conditions for better repeated-condition performance. - Concurrent runtime state for cooldowns and one-time event tracking. - Cleaner addon API for custom actions, placeholders, variables, and custom events. - Client-side features that traditional server-only plugins cannot provide, such as HUD, camera, key blocking, and key combos. - A simpler core that avoids loading large plugin-style systems when they are not needed. ## Event Types ConditionsMod includes event types for: - Player join, leave, death, kill, chat, command, respawn, teleport, damage, sneak, jump, inventory, stats, food, air, and more. - Block break, place, and interact. - Item interact, consume, pickup, drop, craft, enchant, repair, move, and select. - Entity interact and spawn. - Server start, stop, repetitive server checks, custom events, and call events. - Client features such as HUD display, camera, key, and key combo events. ## Conditions Conditions support common operators: ```text ==, !=, equals, !equals equalsIgnoreCase, !equalsIgnoreCase contains, !contains startsWith, !startsWith endsWith, !endsWith matches, !matches >, >=, <, <= ``` Examples: ```yaml conditions: - "%player_world% == overworld" - "%main_command% equalsIgnoreCase /spawn" - "%args_length% == 0 execute no_args" - "%block% matches (?i)(minecraft:)?stone_button" ``` ## Actions Available actions include: - `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` ## Special Features ### Camera Camera events can change the player camera mode or perspective, allowing effects such as 2D views, RPG-style views, and custom camera positions. ### HUD HUD events can display custom on-screen text with position, scale, background, duration,