NeoOrigins 2.0 Condition Reference
Conditions evaluate to true/false against an entity (usually the power’s owning player). They gate power activation, action_on_event triggers, conditional wrappers, bientity interactions, and (as of v2.0.20) any power type via the universal condition gate.
Canonical namespace: neoorigins:* is the preferred form for new packs. Legacy origins:* and apace:* prefixes still work but log a one-shot [2.0-legacy] deprecation warning. Bare type names (e.g. "type": "and") are auto-prefixed with neoorigins:. Section headers below still show the traditional origins:* names for familiarity with upstream documentation; the JSON examples use the canonical neoorigins:* form.
Fail-closed semantics: a malformed or unsupported condition logs a warning and returns false rather than throwing. Bientity / damage / food conditions that require a dispatch context also return false when evaluated outside that context.
Object or array. Every condition-valued field (condition, …) accepts either a single condition object or an array. An array is combined as logical AND (an implicit neoorigins:and): every element must pass. An empty array is treated as always-true. (Previously a bare array in these fields silently no-opped.)
Universal inverted field: every condition supports a top-level "inverted": true flag that flips its result. Compatible with the Apoli/Origins convention used by upstream packs.
Universal power condition gate (v2.0.20+)
Every power type (passive, toggle, active, persistent effect, compat) supports an optional top-level power_condition field and power_condition_mode field. This allows any power to be gated or blocked by entity conditions without needing per-type condition support.
Note: The field is named
power_condition(notcondition) to avoid colliding with power types that already useconditionin their own config (e.g.condition_passive,action_on_event,attribute_modifier). On types that do not claimconditionfor their own config, a top-levelconditionis accepted as an alias forpower_conditionwith modeallow. See the common-fields table in POWER_TYPES.md for the exact alias rules.
| Field | Type | Default | Description |
|---|---|---|---|
power_condition | condition object | (none) | Entity condition using the full DSL documented below |
power_condition_mode | "deny" or "allow" | "deny" | How the condition result maps to power operation |
Modes:
"deny"(default): the power is disabled when the condition evaluates to true. Use this to express “this power doesn’t work when X”."allow": the power only operates when the condition evaluates to true. Use this to express “this power only works when X”.
What gets gated: onTick, onActivated (keybind), onHit, onKill, and capability checks are all suppressed when the condition is not satisfied. Lifecycle methods (onGranted, onRevoked, onLogin, onRespawn) are never gated, so powers can still set up and tear down correctly.
Examples:
Block wraith phase when in water AND exposed to sun:
{
"type": "neoorigins:wraith_phase",
"blocked_blocks": ["minecraft:obsidian"],
"power_condition": {
"type": "neoorigins:and",
"conditions": [
{ "type": "neoorigins:in_water" },
{ "type": "neoorigins:exposed_to_sun" }
]
},
"power_condition_mode": "deny"
}
Flight only works in the Nether:
{
"type": "neoorigins:flight",
"power_condition": { "type": "neoorigins:dimension", "dimension": "minecraft:the_nether" },
"power_condition_mode": "allow"
}
Active teleport blocked while sneaking:
{
"type": "neoorigins:active_teleport",
"range": 32,
"cooldown_ticks": 60,
"power_condition": { "type": "neoorigins:sneaking" },
"power_condition_mode": "deny"
}
// "true when the player is NOT swimming"
{ "type": "neoorigins:swimming", "inverted": true }
// inside an AND, etc.
{ "type": "neoorigins:and", "conditions": [
{ "type": "neoorigins:creative_flying" },
{ "type": "neoorigins:on_fire", "inverted": true }
]}
The inverted flag is also honored on nested conditions inside and / or / not wrappers: every recursive parse pass checks for it.
Common comparison fields: most numeric conditions accept "comparison" (one of ==, !=, <, <=, >, >=) and "compare_to" (number). Defaults to ">=" and 0 unless stated otherwise.
Item conditions, the separate verb set that matches against an ItemStack (used inside equipped_item / inventory entity conditions, event-power item_condition filters, and if_else item actions), is documented in the Item conditions section of ACTIONS.md.
Meta conditions
neoorigins:and (alias neoorigins:all_of)
Logical AND of nested conditions. all_of is Apoli 2.9+’s rename of and: imported packs using origins:all_of / apoli:all_of dispatch here unchanged.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
conditions | array of condition objects | yes | [] | Inner conditions; all must pass |
Example:
{ "type": "neoorigins:and", "conditions": [ {"type": "neoorigins:sneaking"}, {"type": "neoorigins:on_ground"} ] }
neoorigins:or (alias neoorigins:any_of)
Logical OR of nested conditions. any_of is Apoli 2.9+’s rename of or: imported packs using origins:any_of / apoli:any_of dispatch here unchanged.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
conditions | array of condition objects | yes | [] | Inner conditions; at least one must pass |
neoorigins:not
Negates a single inner condition.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
condition | condition object | yes | — | Condition to negate |
neoorigins:actor_condition
Unwraps and evaluates the inner condition against the actor. In Apoli this filters the actor half of a bientity pair; here the inner condition is simply evaluated on the entity under test (the player). Fails closed when condition is missing.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
condition | condition object | yes | — | Inner condition evaluated on the actor |
Example:
{ "type": "neoorigins:actor_condition", "condition": { "type": "neoorigins:sneaking" } }
neoorigins:constant
Always-true or always-false literal.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | boolean | no | false | Literal result. Missing field treated as false. |
Entity conditions
These evaluate against a single entity, usually the power’s owning player.
neoorigins:sneaking
True while shift is held. No fields.
neoorigins:sprinting
True while sprinting. No fields.
neoorigins:on_ground
True while standing on a block. No fields.
neoorigins:in_water
True while touching water. No fields.
neoorigins:swimming
True while the swim animation is active. No fields.
neoorigins:submerged_in_water
True while the eye position is inside water. No fields.
neoorigins:fall_flying
True while elytra-gliding. No fields.
neoorigins:invisible
True while the invisible flag is set. No fields.
neoorigins:moving
True while horizontal delta-movement is nonzero. No fields.
neoorigins:in_rain
True when rain is falling at the entity’s block position with sky access (server-side only); returns false while mounted. If Vampires Need Umbrellas is installed, holding an umbrella in either hand or a Curios slot blocks the rain entirely (mirroring exposed_to_sun), so rain/water-damage origins like Wet Fur and True Hydrophobia stop hurting while you carry one.
neoorigins:daytime
True for in-game times 0–12999. No fields.
neoorigins:exposed_to_sky
True when the sky is visible from the entity’s block position (server-side only).
neoorigins:exposed_to_sun
True during daytime (time 0–11999) with sky access and no rain. Includes helmet protection (damageable helmets absorb the burn at the cost of durability). Helmets in the neoorigins:sun_permeable item tag (open/mesh helmets, minecraft:chainmail_helmet by default) do not shade the player; add modded see-through helmets to that tag via a datapack. Helmet protection as a whole can be disabled with the [sun_damage] helmet_protection config. If Vampires Need Umbrellas is installed, holding an umbrella in either hand or a Curios slot blocks sun damage entirely (checked before helmets).
neoorigins:on_fire (alias neoorigins:fire)
True while the entity is on fire. No fields.
This is always false on a fire-immune origin. A prevent_action power with action: fire clears the burning timer every tick, so the flame overlay does not flicker while the player stands in lava, and on_fire reads that same timer. Gating a power on on_fire inside an origin that also prevents fire therefore never triggers, and does so silently. To key off “while burning” on such an origin, use something the immunity does not erase: in_lava, a dimension check for the Nether, or a modify_damage power that sees the fire damage before it is cancelled.
neoorigins:passenger (alias neoorigins:riding)
True while the entity is a passenger of something. No fields.
neoorigins:using_item
True while the entity is actively using an item (eating, drawing bow, etc.). No fields.
neoorigins:ticking
True unless the entity has been removed. No fields.
neoorigins:exists
True when the entity is non-null and not removed. No fields.
neoorigins:living
True when isAlive() returns true. No fields.
neoorigins:always_active
Unconditionally true. No fields. Apoli-format packs use it as an explicit “no gate” marker on action_over_time and conditional wrappers, where omitting condition entirely would be ambiguous. Equivalent to { "type": "neoorigins:constant", "value": true }. The universal inverted flag still applies, so { "type": "neoorigins:always_active", "inverted": true } is always false.
neoorigins:creative_flying
True when creative flight is engaged. No fields.
neoorigins:creative_mode
True when the player is in creative or spectator gamemode. No fields. Apoli-derivative packs (Medieval Origins Revival etc.) use this to gate resource drains so they don’t run for creative players; medievalorigins:creative_mode dispatches here via the namespace fallback.
neoorigins:block_collision
True when the entity’s bounding box, shifted by offset_x/offset_y/offset_z, intersects at least one matching block. Apoli semantics: the offsets are multipliers of the box’s own dimensions (X and Z scale by the entity’s width, Y by its height), so "offset_x": 0.01 nudges the box 1% of the entity’s width. With a block_condition, at least one intersected block must match it; without one, any block with a real collision shape counts.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
offset_x | float | no | 0.0 | Box X shift as a multiple of the entity’s width |
offset_y | float | no | 0.0 | Box Y shift as a multiple of the entity’s height |
offset_z | float | no | 0.0 | Box Z shift as a multiple of the entity’s width |
block_condition | block condition | no | any collidable block | Block filter; supports block/id, in_tag, fluid, light_level, exposed_to_sky, movement_blocking, and/or, block_state, height, adjacent, and the offset wrapper |
Example: touching an iron-tagged block on either side
{
"type": "neoorigins:block_collision",
"offset_x": 0.01,
"block_condition": { "type": "neoorigins:in_tag", "tag": "fairy:iron" }
}
neoorigins:collided_horizontally
True when the entity ran into a wall this tick: a thin wrapper over vanilla Entity.horizontalCollision, mirroring Apoli’s condition of the same name. Used by conditioned climbing powers (e.g. Origins++) that should only engage while the player is pressed against a surface.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| (no fields) | — | — | — | Marker condition. |
neoorigins:replacable (alias neoorigins:replaceable)
True when the block at the entity’s block position is replaceable (air, short grass, snow layers, etc.; vanilla canBeReplaced()). Apoli-parity condition; the misspelled replacable is the canonical Apoli name, and the corrected replaceable spelling is accepted as a synonym. No fields.
Example:
{ "type": "neoorigins:replacable" }
neoorigins:health
Numeric comparison against current health.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
comparison | string | no | ">=" | Comparison operator |
compare_to | number | no | 0.0 | Health threshold |
neoorigins:relative_health
Numeric comparison against health / maxHealth (0.0–1.0).
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
comparison | string | no | ">=" | Comparison operator |
compare_to | number | no | 0.0 | Ratio threshold |
neoorigins:food_level (alias neoorigins:food)
Numeric comparison against food level (0–20).
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
comparison | string | no | ">=" | Comparison operator |
compare_to | number | no | 0.0 | Hunger threshold |
neoorigins:saturation_level
Numeric comparison against the player’s food saturation level.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
comparison | string | no | ">=" | Comparison operator |
compare_to | number | no | 0.0 | Saturation threshold |
Example:
{ "type": "neoorigins:saturation_level", "comparison": "<", "compare_to": 2.0 }
neoorigins:fall_distance
Numeric comparison against the entity’s fallDistance field.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
comparison | string | no | ">=" | Comparison operator |
compare_to | number | no | 0.0 | Distance in blocks |
neoorigins:height
Numeric comparison against the entity’s Y coordinate.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
comparison | string | no | ">=" | Comparison operator |
compare_to | number | no | 0.0 | World Y threshold |
neoorigins:armor_value
Numeric comparison against the entity’s armor value.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
comparison | string | no | ">=" | Comparison operator |
compare_to | number | no | 0.0 | Armor points |
neoorigins:amount
Generic numeric wrapper. Standalone fallback compares against current health: context-dependent, retained for pack compatibility.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
comparison | string | no | ">=" | Comparison operator |
compare_to | number | no | 0.0 | Threshold |
neoorigins:xp_level
Numeric comparison against experienceLevel. Also registered as neoorigins:xp_levels (same fields, same behavior; both are canonical types, not aliases).
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
comparison | string | no | ">=" | Comparison operator |
compare_to | int | no | 0 | Level threshold |
neoorigins:xp_levels
Numeric comparison against the entity’s experience level. A synonym of neoorigins:xp_level (same fields, same behaviour; both are canonical types).
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
comparison | string | no | ">=" | Comparison operator |
compare_to | int | no | 0 | Experience-level threshold |
Example:
{ "type": "neoorigins:xp_levels", "comparison": ">=", "compare_to": 30 }
neoorigins:xp_points
Numeric comparison against totalExperience.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
comparison | string | no | ">=" | Comparison operator |
compare_to | int | no | 0 | Points threshold |
neoorigins:air
Numeric comparison against the entity’s air supply (0–300; full air is 300, drowning starts at 0).
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
comparison | string | no | ">=" | Comparison operator |
compare_to | number | no | 0.0 | Air-supply threshold (0–300) |
Example:
{ "type": "neoorigins:air", "comparison": "<", "compare_to": 60 }
neoorigins:dimension
Checks current dimension ID.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
dimension | resource location | no | — | e.g. "minecraft:overworld"; always-true when absent |
neoorigins:biome
Checks biome at the entity’s block position. Precedence: biome > tag/biome_tag > condition.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
biome | resource location | no | — | Exact biome ID |
tag | resource location | no | — | Biome tag (used when biome absent) |
biome_tag | resource location | no | — | Synonym for tag (used by several built-in JSONs) |
condition | object | no | — | Nested biome sub-condition (used when no ID/tag present) |
Always-true when none of the fields are present.
Nested condition: the biome sub-grammar
The condition field takes its own small grammar, distinct from the entity-condition grammar above: everything in it describes the biome at the entity’s block position, not the entity. In particular in_tag here means “the biome is in this biome tag”, not “the entity is of a type in this entity-type tag”.
| Sub-type | Fields | Description |
|---|---|---|
and / all_of | conditions (array or single object) | True when every child is true |
or / any_of | conditions (array or single object) | True when any child is true |
not | condition (object) | Negates one child |
constant | value (boolean, default false) | Fixed result |
biome | same fields as neoorigins:biome | Nested exact-ID or tag check, for use inside an or-list |
in_tag | tag (resource location, required) | Biome is in this biome tag |
temperature | comparison, compare_to | Compares the biome’s base temperature |
precipitation | precipitation: "none" / "rain" / "snow" (required) | What falls at this position |
high_humidity | — | Biome downfall is above 0.85 |
Every sub-type also accepts inverted (boolean, default false), which negates its result.
precipitationis resolved per-block, not per-biome: the same biome rains at sea level and snows on the peaks, and that is what Apoli does. The level’s own sea level is used, so a datapack dimension that raises it still answers correctly. The0.85humidity threshold is Apoli’s own, kept verbatim so packs tuned against it still agree.
An unrecognised sub-type logs a warning and fails closed: the power will not activate. That is deliberate. A biome-gated power that fires in every biome is a much louder bug than one that never fires, and this grammar is small enough that an unknown verb is a genuine gap rather than a niche we chose not to cover.
Example:
{ "type": "neoorigins:biome",
"condition": { "type": "neoorigins:temperature", "comparison": "<", "compare_to": 0.15 } }
Example — combinators:
{ "type": "neoorigins:biome",
"condition": {
"type": "neoorigins:or",
"conditions": [
{ "type": "neoorigins:in_tag", "tag": "minecraft:is_jungle" },
{ "type": "neoorigins:high_humidity" },
{ "type": "neoorigins:precipitation", "precipitation": "snow", "inverted": true }
]
} }
neoorigins:in_tag
Biome tag check (equivalent to neoorigins:biome with tag).
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
tag | resource location | no | — | Biome tag ID; always-true when absent |
neoorigins:submerged_in
Fluid-membership check at the entity’s eye position.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
fluid | string | no | "" | "minecraft:water", "minecraft:lava", or anything else (matches either) |
neoorigins:fluid_height
Numeric comparison against the submersion height for a given fluid tag.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
fluid | string | no | "" | "minecraft:water" or "minecraft:lava"; otherwise compares against 0 |
comparison | string | no | ">=" | Comparison operator |
compare_to | number | no | 0.0 | Height threshold |
neoorigins:temperature
Numeric comparison against the biome’s base temperature.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
comparison | string | no | ">=" | Comparison operator |
compare_to | number | no | 0.0 | Temperature threshold |
neoorigins:body_temperature
Numeric comparison against a player’s Cold Sweat (cold_sweat) temperature reading. Integration condition: gate the power with "required_mods": ["cold_sweat"]. When Cold Sweat is absent the condition fails closed (always false) and logs a warning.
Distinct from neoorigins:temperature above (which reads the biome’s base temperature). Cold Sweat’s core (body) temp runs roughly −100 (freezing death) … +100 (burning death), 0 = neutral; base/world use the ambient scale; resistance/dampening traits sit in a ~0..1 range.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
trait | enum | no | core | Which trait to read: core, base, world, heat_resistance, cold_resistance, heat_dampening, cold_dampening, freezing_point, burning_point, rate |
comparison | string | no | ">=" | Comparison operator |
compare_to | number | no | 0 | Threshold the reading is compared against |
Example: true once the player is dangerously hot
{ "type": "neoorigins:body_temperature", "trait": "core", "comparison": ">=", "compare_to": 50 }
neoorigins:light_level
Numeric comparison against ambient light at the entity’s block position. Also registered as neoorigins:brightness (same fields, same behavior; both are canonical types, not aliases).
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
light_type | string | no | "any" | "sky", "block", or "any" |
comparison | string | no | ">=" | Comparison operator |
compare_to | int | no | 0 | Light threshold (0–15) |
Omitting light_type (or any value other than "sky"/"block") samples the max local brightness, the higher of the sky and block light layers.
neoorigins:brightness
Numeric comparison against ambient light at the entity’s block position. A synonym of neoorigins:light_level (same fields, same behaviour; both are canonical types).
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
light_type | string | no | "any" | Which light layer to sample: "sky", "block", or "any" (max local brightness) |
comparison | string | no | ">=" | Comparison operator |
compare_to | int | no | 0 | Light threshold (0–15) |
Example:
{ "type": "neoorigins:brightness", "comparison": "<=", "compare_to": 7 }
neoorigins:time_of_day
Numeric comparison against level.getDayTime() % 24000.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
comparison | string | no | ">=" | Comparison operator |
compare_to | long | no | 0 | Tick within day |
neoorigins:weather
Checks the current weather state against one of clear, rain, raining, thunder, or thundering; rain/raining and thunder/thundering are synonyms, matched case-insensitively. clear means neither raining nor thundering; rain means raining but not thundering; thunder matches any thunderstorm. Unusual: accepts either "state" or "value"; with both absent the state defaults to "clear".
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
state | string | no | "clear" | "clear", "rain"/"raining", or "thunder"/"thundering" (case-insensitive) |
value | string | no | — | Synonym for state (read when state absent) |
neoorigins:moon_phase
Numeric comparison against the moon phase index 0–7. Default comparison is "==".
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
comparison | string | no | "==" | Comparison operator |
compare_to | int | no | 0 | Phase index |
neoorigins:on_block
True when the entity is on ground and the block directly below matches the nested block condition. When block_condition is omitted entirely, the condition is just “standing on any block” (plain onGround() check).
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
block_condition | object | no | — | Nested block condition (block/id, in_tag, fluid, light_level, exposed_to_sky, movement_blocking, block_state, height, adjacent, offset, or an and/or combinator); absent → on any ground |
block_condition.id | resource location | no | — | Block ID to match (also accepts block) |
neoorigins:block
Block check at the entity’s current position: accepts either a nested block_condition object or the same fields at the top level.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
block_condition | object | no | — | Optional wrapper; the full block-condition grammar (block/id, in_tag, fluid, light_level, exposed_to_sky, movement_blocking, block_state, height, adjacent, offset, and/or) |
block / id | resource location | no | — | Exact block ID |
tag | resource location | no | — | Block tag (used when ID absent) |
Unusual: accepts block or id for the block ID, and will read fields at top level if block_condition is omitted.
A wrapper with no block condition in it at all still means “any block”. A block condition the game cannot read means no block — see the note under neoorigins:in_block.
neoorigins:in_block
The block occupying the entity’s own position must match the nested block condition.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
block_condition | object | no | — | Nested block condition; absent → any block |
neoorigins:in_block_anywhere
Counts every block position the entity’s bounding box overlaps whose block matches block_condition, then compares that count. Distinct from in_block, which samples only the single block at the entity’s feet — a crouching entity brushing a cobweb with the edge of its hitbox still counts as “in” it.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
block_condition | object | no | — | Nested block condition; absent → any block |
comparison | string | no | ">=" | Comparison operator against the count |
compare_to | int | no | 1 | Count to compare against |
When a block condition cannot be read
If a block_condition names a verb this version does not implement, the whole condition matches nothing — the power never fires, and its inverted twin does not fire either. It is deliberately not the other way round: a check that silently passes is a check nobody notices is broken. The unreadable verb is named in the [CompatB] Compatibility summary block written at pack reload.
neoorigins:hardness
Numeric comparison against a block’s destroy hardness. Context-dependent: inside a raycast block_action dispatch it tests the raycast-hit block; otherwise it falls back to the block the entity is looking at (20-block pick). False when no block is found. Used by spell-break-style powers (e.g. Mage spell_break).
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
comparison | string | no | ">=" | Comparison operator |
compare_to | number | no | 0.0 | Block hardness threshold |
Example:
{ "type": "neoorigins:hardness", "comparison": "<=", "compare_to": 1.5 }
neoorigins:entity_type
Checks entity type against a resource location. For a player entity this is always minecraft:player.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
entity_type | resource location | no | — | Entity type ID |
type_id | resource location | no | — | Alias for entity_type |
Always-true when both fields are absent.
neoorigins:equipped_item
Inspects an item in a given equipment slot.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
equipment_slot | string | no | "mainhand" | "head", "chest", "legs", "feet", "offhand", or "mainhand" |
item_condition | object | no | — | Nested condition (see below) |
Unusual: item_condition has its own internal shape. Accepts any of:
{ "id": "minecraft:stick" }— exact item ID{ "tag": "c:tools/pickaxe" }— item tag{ "type": "neoorigins:empty" }— slot is empty (alsoapace:empty){ "ingredient": { "item": "..." } }or{ "ingredient": { "tag": "..." } }— ingredient-style wrapper
Always-true when item_condition is absent.
neoorigins:inventory
Counts inventory contents matching an item condition and compares the count against a threshold. The default comparison (> 0) reads as “has at least one match”.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
inventory_types | list of string | no | ["inventory"] | Inventories to scan: inventory (the player’s main inventory, including hotbar, armor and offhand slots) and/or ender_chest |
process_mode | string | no | "stacks" | "stacks" counts matching stacks; "items" sums their stack counts |
item_condition | item condition | no | any non-empty stack | Per-stack predicate: the full item-condition vocabulary (see ACTIONS.md) |
comparison | string | no | ">" | Comparison operator against the count |
compare_to | int | no | 0 | Count threshold |
Apoli’s power field (counting slots inside an apoli:inventory power’s virtual container) is not supported: a condition using it fails closed with a load warning.
Example: carrying at least 16 bones in total
{
"type": "neoorigins:inventory",
"process_mode": "items",
"item_condition": { "type": "neoorigins:ingredient", "item": "minecraft:bone" },
"comparison": ">=",
"compare_to": 16
}
neoorigins:enchantment
Checks the max level of a given enchantment across all equipment slots.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
enchantment | resource location | no | — | Enchantment ID; always-true when absent |
comparison | string | no | ">=" | Comparison operator |
compare_to | int | no | 1 | Level threshold |
neoorigins:resource
Numeric comparison against a named resource power’s stored value.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
resource | resource location | yes | — | Power ID storing the resource |
comparison | string | no | ">=" | Comparison operator |
compare_to | int | no | 0 | Threshold |
⚠️
resourcemust be the full namespaced power ID (e.g.mypack:thorns/resource). Unlikepower_active, the*:/*:*self-reference wildcard is not resolved here: a reference containing*silently reads as0(and is warned about at load). The same applies to thechange_resource/set_resourceactions.
neoorigins:resource_level
Synonym of neoorigins:resource: same factory and fields (resource, comparison, compare_to), accepted so Apoli-format packs using resource_level dispatch directly. The same full-power-id requirement (no * wildcard) applies.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
resource | resource location | yes | — | Power ID storing the resource |
comparison | string | no | ">=" | Comparison operator |
compare_to | int | no | 0 | Threshold |
Example:
{ "type": "neoorigins:resource_level", "resource": "mypack:mana", "comparison": ">=", "compare_to": 20 }
neoorigins:power
True when the entity has the given power granted, either through any of its chosen origins’ power lists or as a dynamic grant. Distinct from power_active (which tests whether a toggle power is currently on) and power_type (which matches by power type ID rather than power ID).
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
power | resource location | yes | — | Power ID to look for; always-false when absent |
Example:
{ "type": "neoorigins:power", "power": "mypack:night_vision" }
neoorigins:power_active
Whether a named toggle power is currently active (toggled on) on this entity. Works with:
neoorigins:togglepowers: resolves thedefaultfield if the toggle has never been flipped.- Native toggle powers:
wraith_phase,flight,phantom_form, and any other power that extends the internal toggle system (skill-key toggled powers).
Use this to gate other powers so they only tick while a specific toggle is on. For example, apply debuffs only while phasing is active, or drain a resource only while flight is toggled on.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
power | resource location | yes | — | Power ID to check (e.g. "mypack:wraith_phase", "mypack:my_toggle") |
{
"type": "neoorigins:condition_passive",
"name": "Phasing Hunger",
"description": "Phasing drains your hunger.",
"hidden": true,
"interval": 20,
"condition": { "type": "neoorigins:power_active", "power": "mypack:wraith_phase" },
"entity_action": { "type": "neoorigins:exhaust", "amount": 1.0 }
}
Combine with neoorigins:and to add extra gates:
"condition": {
"type": "neoorigins:and",
"conditions": [
{ "type": "neoorigins:power_active", "power": "mypack:wraith_phase" },
{ "type": "neoorigins:near_block", "tag": "mypack:soul-repellent", "radius": 6 }
]
}
neoorigins:power_type
Whether any power granted to this entity has a matching type ID.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
power_type | resource location | yes | — | Power type ID (e.g. neoorigins:toggle) |
id | resource location | no | — | Alias for power_type |
Bare type names (no :) are auto-prefixed with neoorigins:.
neoorigins:origin
True when the player currently has the named origin, optionally scoped to a single layer. Mirrors Apoli’s origins:origin entity condition. Use it to gate a power or condition on which origin the player is.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
origin | resource location | yes | — | Origin id the player must currently have (e.g. neoorigins:merling). |
layer | resource location | no | any layer | Restrict the match to a single origin layer; omit to match the origin in any layer. |
Example: only while playing the Merling origin
{ "type": "neoorigins:origin", "origin": "neoorigins:merling" }
neoorigins:cooldown
Inverted polarity: true when the named power is not on cooldown (i.e. ready to use). Use "inverted": true to test “is on cooldown” instead. Always-true when power is absent.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
power | resource location | no | — | Power ID whose cooldown to test; always-true when absent |
Example:
{ "type": "neoorigins:cooldown", "power": "mypack:fireball" }
neoorigins:nbt
Simplified NBT presence check: true when the entity’s persistent data contains a given top-level key.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
nbt | string | no | — | Compound key name; always-true when absent |
neoorigins:scoreboard
Numeric comparison against the player’s score on a named objective.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
objective | string | yes | — | Scoreboard objective name; always-false when absent |
comparison | string | no | ">=" | Comparison operator |
compare_to | int | no | 0 | Score threshold |
neoorigins:statistic
Numeric comparison against one of the player’s vanilla statistics, the same numbers the in-game Statistics screen shows.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
statistic | string or object | yes | — | The stat to read (see below); always-false when absent or unreadable |
stat | string or object | no | — | Alias for statistic: the Apoli field name; same two shapes |
comparison | string | no | ">=" | Comparison operator |
compare_to | int | no | 0 | Statistic threshold |
Two accepted shapes. A plain id is read as a custom stat:
{ "type": "neoorigins:statistic",
"statistic": "minecraft:time_since_rest",
"comparison": ">=",
"compare_to": 24000 }
An object selects the stat category explicitly; this is the form upstream Apoli documents, and the only way to reach the non-custom categories:
{ "type": "neoorigins:statistic",
"stat": { "type": "minecraft:killed", "stat": "minecraft:zombie" },
"comparison": ">=",
"compare_to": 100 }
Categories. minecraft:custom (the default), minecraft:mined, minecraft:crafted, minecraft:used, minecraft:broken, minecraft:picked_up, minecraft:dropped, minecraft:killed, minecraft:killed_by. A modded stat type is accepted too and resolved against the stat-type registry. Ids without a namespace are assumed to be minecraft:.
Fail-closed. A missing stat field, a malformed id, an unknown minecraft: category, or an id that no registry entry backs all evaluate to false and log once: a statistic gate never silently opens. Resolution happens on first evaluation, not at pack load, so stats registered by other mods are still found.
Example: a debuff that builds up when the player hasn’t slept for a full day
{ "type": "neoorigins:statistic",
"statistic": "minecraft:time_since_rest",
"comparison": ">=",
"compare_to": 24000 }
neoorigins:command
Runs an arbitrary server command with suppressed output and returns true if no exception was thrown.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
command | string | yes | — | Command text (no leading slash); always-false when blank |
Unusual: this does not test exit code. It returns true unless the command threw. Check the feasibility of any JSON-condition written this way carefully.
neoorigins:advancement
True when the player has completed the given advancement (server-side only; unknown advancement IDs return false).
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
advancement | resource location | yes | — | Advancement ID the player must have completed; always-false when absent |
Example:
{ "type": "neoorigins:advancement", "advancement": "minecraft:story/enter_the_nether" }
neoorigins:predicate
Meta-wrapper around vanilla Minecraft predicates. Unusual: dispatches on predicate_type, and the inner predicate object is codec-parsed once at load.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
predicate_type | string | yes | — | One of biome, block_state, entity_properties, fluid_state, item, location, damage |
predicate | object | yes | — | Inner JSON in that predicate’s vanilla codec |
Supported predicate_type values and the check they perform:
biome: biome at the entity’s block position; inner shape{ "biomes": ["..."], "tag": "..." }(at least one required)block_state: vanillaBlockPredicateat the entity’s block positionentity_properties: vanillaEntityPredicateagainst this entityfluid_state: vanillaFluidPredicateat the entity’s block positionitem: vanillaItemPredicateagainst the entity’s mainhandlocation: vanillaLocationPredicateat the entity’s positiondamage: fails closed (requires damage-source context; use action-on-hit hooks instead)
neoorigins:config_flag
True when the named server config flag is currently enabled. Pack authors use this to gate powers on server-operator toggleable settings (e.g. letting admins disable diet restrictions or dry-out mechanics globally).
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | no | "" | Config flag key. Unknown keys log a warning and default to true (fail-open). |
Supported keys:
"ocean_origins.fish_diet_required": whether ocean origins enforce fish-only diet"ocean_origins.dries_out": whether ocean origins take dry-out damage on land
Example: only enforce fish diet when the server has it enabled
{ "type": "neoorigins:config_flag", "key": "ocean_origins.fish_diet_required" }
Context-aware conditions
These read from ActionContextHolder populated during an action dispatch. They fail closed outside a matching context.
neoorigins:hit_taken_amount
Numeric comparison against the hit damage currently being taken. Requires an active HitTakenContext. Used by action_on_hit_taken to re-express min_damage.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
comparison | string | no | ">=" | Comparison operator |
compare_to | number | no | 0.0 | Damage threshold |
neoorigins:hit_dealt_amount
Numeric comparison against the most recent damage the player dealt to a target. Requires an active HitDealtContext, the attacker-side mirror of hit_taken_amount, populated when the player damages a living entity (player-vs-mob included). Hook it from an action_on_event power with "event": "hit_dealt". Inside that dispatch a bientity target_action resolves the victim that was struck.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
comparison | string | no | ">=" | Comparison operator |
compare_to | number | no | 0.0 | Dealt-damage threshold |
neoorigins:food_item_in_tag
True if the item being eaten in the current FOOD_EATEN dispatch matches a tag or item ID. Requires an active FoodContext. Used by food_restriction aliases.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
tag | string | no | — | Item tag (prefix with #, e.g. "#minecraft:meat") or bare item ID (e.g. "minecraft:spider_eye"). Always-false when absent. |
Tag vs item: a leading # denotes a tag lookup; without # the value is matched as an exact item ID.
Built-in diet tags
NeoOrigins ships these item tags for its diet-restricted origins, under data/neoorigins/tags/item/. All are declared "replace": false, so a datapack can append to any of them without redefining the list. Cross-mod entries are marked required: false, so they no-op when the other mod is absent.
| Tag | Diet / origin | Contents |
|---|---|---|
#neoorigins:fish_foods | Pescivore (ocean/aquatic origins) | cod, salmon, tropical fish, pufferfish, cooked cod, cooked salmon; plus optional #c:foods/raw_fish, #c:foods/cooked_fish, and Aquaculture fish fillet + sushi |
#neoorigins:meat_foods | Carnivore | beef, porkchop, mutton, chicken, rabbit (raw + cooked each), rabbit stew, rotten flesh; plus optional #c:foods/raw_meat, #c:foods/cooked_meat, and Aquaculture turtle soup |
#neoorigins:vampire_foods | Blood diet (Vampire) | beef, porkchop, chicken, mutton, rabbit, rotten flesh, spider eye |
#neoorigins:skeleton_foods | Boneless diet (Skeleton, base) | bone meal, rotten flesh, spider eye |
#neoorigins:skeleton_evolved_foods | Boneless diet (Skeleton, evolved) | skeleton base list + all cooked meats and cooked fish (beef, porkchop, chicken, mutton, rabbit, cod, salmon) |
The fish diet additionally reads a server config allowlist: the neoorigins:aquatic_fish_diet power accepts either the #neoorigins:fish_foods tag or any entry in ocean_origins.extra_fish_foods (see food_item_in_config_list below), and only enforces the restriction when the ocean_origins.fish_diet_required flag is on.
neoorigins:food_item_id
True if the item being eaten in the current FOOD_EATEN dispatch is an exact item-ID match. Requires an active FoodContext; returns false outside that context. Sibling of food_item_in_tag. Use this when you need per-item bonuses (e.g. raw cod gets one bonus, cooked cod gets a different one).
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
id | resource location | yes | — | Exact item ID to match (e.g. "minecraft:cod"). Unknown IDs fail closed. |
Example: bonus saturation when eating raw cod
{
"condition": { "type": "neoorigins:food_item_id", "id": "minecraft:cod" },
"action": { "type": "neoorigins:modify_food", "food": 3, "saturation": 5.6 }
}
food_item_id vs food_item_in_tag: food_item_id matches a single exact item. food_item_in_tag matches by tag (or bare ID), so it can cover many items in one rule. Use food_item_id when you need different behavior per individual food item.
neoorigins:food_item_in_config_list
True if the item being eaten in the current FOOD_EATEN dispatch matches any entry in a named server config list. Requires an active FoodContext; returns false outside that context, and false for an unknown key. Each list entry is either a bare item ID or a #-prefixed tag ref, matched the same way as food_item_in_tag.
This lets a server owner extend a diet without editing a datapack: the ocean-origin fish diet reads ocean_origins.extra_fish_foods so modded fish (Aquaculture, Hybrid Aquatic, etc.) can be whitelisted from config.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | yes | — | Config list key to read (e.g. "ocean_origins.extra_fish_foods"). Unknown keys evaluate false. |
Supported keys:
"ocean_origins.extra_fish_foods": extra items/tags ocean origins may eat, additive to theneoorigins:fish_foodstag.
Example: allow the eat when it is a fish tag OR a config-listed item
{
"type": "neoorigins:any_of",
"conditions": [
{ "type": "neoorigins:food_item_in_tag", "tag": "#neoorigins:fish_foods" },
{ "type": "neoorigins:food_item_in_config_list", "key": "ocean_origins.extra_fish_foods" }
]
}
Bientity conditions
These evaluate against a pair: the entity under test (actor) plus a target pulled from the active dispatch context. They fail closed outside a bientity context.
Target extraction rules (from ActionContextHolder.get()):
HitTakenContext: target = the damage source entity (if it’s aLivingEntity)KillContext: target = the killed entityEntityInteractContext: target = the interacted entityProjectileHitContext: target = the entity hit (if any)- otherwise: null, condition returns false
Apoli bientity_condition fields. Where a field is typed bientity condition (area_of_effect.bientity_condition, prevent_entity_use.bientity_condition, the bientity if_else gate), the pair is handed in directly rather than pulled from the dispatch context. Those slots accept target_condition and actor_condition (each wrapping an ordinary condition, evaluated against that side of the pair), can_see, constant, and the combinators and/all_of, or/any_of, not; inverted is honoured on every node. Anything else cannot be compiled, and each call site documents what it does about that.
neoorigins:distance
Numeric comparison against 3D distance from actor to target. Default comparison is "<=" (unlike most numeric conditions).
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
comparison | string | no | "<=" | Comparison operator |
compare_to | number | no | 0.0 | Distance in blocks |
neoorigins:distance_from_coordinates
Numeric comparison against the entity’s distance from a reference point (world_origin at 0,0,0 or world_spawn), with selectable distance metric and per-axis exclusion.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
comparison | string | no | "==" | Comparison operator |
compare_to | number | no | 0.0 | Distance threshold (required in practice) |
reference | string | no | "world_origin" | Reference point: world_origin (0,0,0) or world_spawn |
offset | object | no | — | Per-axis {x,y,z} offset added to the reference point |
shape | string | no | "cube" | Distance metric: cube (Chebyshev), star (Manhattan), sphere (Euclidean) |
ignore_x | bool | no | false | Exclude the X axis from the distance |
ignore_y | bool | no | false | Exclude the Y axis from the distance |
ignore_z | bool | no | false | Exclude the Z axis from the distance |
result_on_the_wrong_dimension | number | no | — | Distance value substituted when off the reference’s dimension (absent → use real distance) |
Example: within 100 blocks of world spawn (horizontal only)
{ "type": "neoorigins:distance_from_coordinates",
"reference": "world_spawn",
"shape": "sphere",
"ignore_y": true,
"comparison": "<=",
"compare_to": 100 }
neoorigins:can_see
True when the actor has line-of-sight to the target. No fields.
neoorigins:equal
True when target UUID == actor UUID. No fields.
neoorigins:target_type
Checks target’s entity-type ID or tag. Unusual: a leading # denotes a tag.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
entity_type | string | yes | — | e.g. "minecraft:zombie" or "#minecraft:undead"; always-false when blank |
neoorigins:target_group
Checks whether the target’s entity type is in a vanilla mob-category tag under the minecraft: namespace.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
group | string | yes | — | Tag path under minecraft: (e.g. "raiders"); always-false when blank |
neoorigins:in_set (alias neoorigins:in_set)
2.0 entity-set membership: true when the target’s UUID is in the actor’s named entity-set. Pack authors should namespace set keys to avoid collision.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
set | string | yes | — | Entity-set key (e.g. "mypack:kill_streak") |
neoorigins:no_minions_alive
True when the player has zero living tracked minions of the given key. Used for “loner” gates, e.g., the Monster Tamer’s Lone Weakness applies only when no tamed mobs are alive. Evaluates to true if the player has never summoned a minion as well (count of 0).
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
key | string | no | "tamer:tamed" | MinionTracker key to count. Defaults to the TameMobPower key. Summoned-mob keys are the entity type string, e.g. "minecraft:skeleton" for SummonMinionPower. |
Damage conditions
Read the DamageSource from HitTakenContext. Fail closed outside that context.
neoorigins:from_fire
True when the damage source is in the minecraft:is_fire damage-type tag. No fields.
neoorigins:from_projectile
True when the damage source is in the minecraft:is_projectile damage-type tag. No fields.
neoorigins:from_explosion
True when the damage source is in the minecraft:is_explosion damage-type tag. No fields.
neoorigins:damage_type
Matches the damage source against a specific damage-type resource key.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
damage_type | resource location | yes | — | Damage-type ID; always-false when blank |
neoorigins:damage_tag
Matches the damage source against a damage-type tag. Leading # is stripped if present.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
tag | resource location | yes | — | Damage-type tag (optional # prefix); always-false when blank |
neoorigins:damage_name (alias neoorigins:name)
Case-insensitive match against the damage source’s message ID (e.g. "lava", "cactus").
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | yes | — | Damage message ID; always-false when blank |
neoorigins:night
True while the level’s in-game time is past 13000 ticks (nightfall) and before the day reset. Logical inverse of neoorigins:daytime.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| (no fields) | — | — | — | Marker condition. |
neoorigins:thundering
True when there’s an active thunderstorm and rain is falling at the player’s position (biome supports rain). Stricter than vanilla’s global isThundering(): won’t fire in dry biomes even during a global thunderstorm.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| (no fields) | — | — | — | Marker condition. |
neoorigins:has_effect
True when the player has the specified MobEffect active. Useful for gating passives on consumable-applied buffs (mirrors the FortuneWhenEffectPower gate pattern for DSL authors).
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
effect | resource location | yes | — | MobEffect ID (e.g. minecraft:luck, minecraft:haste) |
neoorigins:status_effect
True when the player has the specified MobEffect active within an amplifier range. Apoli-parity sibling of has_effect: has_effect is presence-only, while status_effect can additionally gate on the effect’s amplifier.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
effect | resource location | yes | — | MobEffect ID; always-false when absent |
amplifier | int | no | — | Exact amplifier to require (sets both min and max; overrides the fields below) |
min_amplifier | int | no | -1 | Lowest acceptable amplifier (-1 = any) |
max_amplifier | int | no | unbounded | Highest acceptable amplifier |
Example: Strength II or higher
{ "type": "neoorigins:status_effect", "effect": "minecraft:strength", "min_amplifier": 1 }
neoorigins:climbing
True when the player is currently on a climbable block (vanilla ladder, vine, or any block with the wall-climb capability from origins like Arachnid).
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| (no fields) | — | — | — | Marker condition. |
neoorigins:climbing_gate
Internal state machine that drives conditioned origins:climbing powers. It is emitted by the compat translator when a climbing power carries a condition / hold_condition, so it is not normally hand-authored, documented for completeness and for authors debugging converted Apoli packs. It tracks per-player climb state: climbing starts while condition holds and, when allow_holding, keeps going while the player is airborne until hold_condition fails or they touch the ground.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
condition | entity condition | no | always active | Condition that activates climbing; absent → always active. |
hold_condition | entity condition | no | hold until touchdown | Condition that keeps an active climb going after condition stops (evaluated while airborne); absent → hold until the player lands. |
allow_holding | boolean | no | true | Whether an active climb may persist after condition stops. |
neoorigins:out_of_combat
True when at least ticks ticks have elapsed since the player last took damage. Backed by CombatTracker which timestamps damage hits in CombatPowerEvents.onLivingDamage (including cancelled damage: getting hit by invulnerable armor still counts as being attacked). Forgotten on logout.
Useful for gating rest / regen / out-of-combat-only buffs.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
ticks | int | no | 100 | Ticks since last damage hit. 100 = 5 seconds. |
Example: regen only while out of combat
{ "type": "neoorigins:out_of_combat", "ticks": 100 }
Typically combined with near_block or biome in an neoorigins:and so the buff only applies when both safe and in the right spot (campfire, village, bed area, etc.).
neoorigins:cover (alias neoorigins:covered_by_block)
True when the column directly above the player contains a non-air block within distance blocks, the “standing under cover” check (inverse of seeing the sky overhead, scoped to a single column). Apoli-parity pair; MoR Wood Elf uses medievalorigins:cover, which dispatches here via the namespace fallback.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
distance | int | no | 8 | How many blocks above the player to scan (minimum 1) |
neoorigins:near_block
Aliases: origins:block_in_radius, apace:block_in_radius
True when any matching block is within a cubic radius of the player. Accepts any combination of single IDs, ID lists, single tags, and tag lists; a block matches if it appears in ANY of the provided blocks/tags (logical OR).
Intended for ambient proximity buffs (campfire warmth, lava-side speed, water-near regen). Capped at radius 8 to avoid expensive per-tick scans.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
block | resource location | no | — | Single block ID to match |
blocks | list of resource location | no | [] | Additional block IDs to match |
tag | block tag | no | — | Single block tag (with or without leading #) |
tags | list of block tag | no | [] | Additional block tags |
block_condition | object | no | — | Origins-format nested block condition (block, in_tag, fluid, light_level, exposed_to_sky, movement_blocking, block_state, height, adjacent, offset, and/or) |
radius | int (1–8) | no | 4 | Cubic radius to scan around the player |
At least one of block/blocks/tag/tags/block_condition must be non-empty.
Example: warm near any fire source
{ "type": "neoorigins:near_block",
"tags": ["minecraft:campfires", "#c:fire"],
"radius": 5 }
neoorigins:block_in_radius
Synonym of neoorigins:near_block: same factory and fields, accepted so Origins-format packs using block_in_radius dispatch directly. Also accepts the Origins block_condition (nested in_tag/block) shape.
Example:
{ "type": "neoorigins:block_in_radius", "block": "minecraft:campfire", "radius": 5 }
neoorigins:near_entity
True when at least one entity of the given type (or entity tag) is within distance blocks of the player. Uses an AABB broad scan followed by Euclidean (spherical) distance filtering for accuracy. Distance capped at 64 blocks to avoid expensive per-tick scans.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
entity_type | resource location or #tag | yes | — | Entity type id (e.g. "minecraft:creeper") or entity tag with # prefix (e.g. "#minecraft:undead"). |
distance | double (1–64) | no | 8.0 | Radius in blocks. |
Example: buff when near wolves
{ "type": "neoorigins:near_entity",
"entity_type": "minecraft:wolf",
"distance": 10 }
Example: debuff when undead are nearby
{ "type": "neoorigins:near_entity",
"entity_type": "#minecraft:undead",
"distance": 16 }
neoorigins:nearby_entities
The counting form of near_entity: it compares how many matching entities are in range, so it can express “fewer than three mobs nearby” as well as “at least one wolf nearby”. Same AABB broad scan followed by Euclidean distance filtering, and the same 64-block cap.
Selectors combine as a logical AND: an entity counts when its type matches entity_type/entity_types (if either is given) and it satisfies bientity_condition (if given). With no selector at all, every entity in range counts, Apoli’s behaviour for a bare nearby_entities.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
entity_type | resource location or #tag | no | — | Entity type id, or entity tag with # prefix. |
entity_types | list of resource location or #tag | no | [] | Additional types/tags; an entity matching any of them counts. |
bientity_condition | object | no | — | Condition evaluated as (player, nearby entity). Only matching entities count. |
distance | double (1–64) | no | 16.0 | Radius in blocks. |
radius | double (1–64) | no | — | Apoli spelling of distance; takes precedence when both are present. |
comparison | comparison | no | >= | Operator applied to the matching-entity count. |
compare_to | double | no | 1 | Count threshold. |
An unknown entity_type id, or a bientity_condition whose verb cannot be evaluated against a non-player entity, fails the condition closed (it never matches) and is reported in the compat summary.
Example: strength in numbers
{ "type": "neoorigins:nearby_entities",
"entity_type": "minecraft:wolf",
"distance": 10,
"comparison": ">=",
"compare_to": 3 }
Example: claustrophobia, using the Apoli form
{ "type": "neoorigins:nearby_entities",
"bientity_condition": {
"type": "neoorigins:target_condition",
"condition": { "type": "neoorigins:entity_type", "entity_type": "#minecraft:undead" }
},
"radius": 8,
"comparison": "<",
"compare_to": 2 }
neoorigins:near_villager
True when a villager is within distance blocks. Not an Apoli verb (it comes from community packs that wanted a plain “am I in a village” gate), and it counts villagers only: wandering traders and zombie villagers are deliberately excluded.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
distance | double (1–64) | no | 16.0 | Radius in blocks. |
comparison | comparison | no | >= | Operator applied to the villager count. |
compare_to | double | no | 1 | Count threshold. |
Example: hero of the village
{ "type": "neoorigins:near_villager", "distance": 32 }