[NaySurGithub]

Batch 1 of the plugin API additions: potion effects, attributes, sounds and particles.

What it adds

• Effects, on any entity (players through player.entity()): entityAddEffect, entityRemoveEffect, entityEffect, entityEffectCount/entityEffectAt, entityClearEffects, with FALCON_EFFECT_* ids (the game's effect ids) and FALCON_EFFECT_INFINITE. A weaker or shorter effect than the running one is refused, as in the game.
• Attributes: entityAttributeCount/entityAttributeName, entityAttribute (value, minimum, maximum, default) and entitySetAttribute, which refuses a value outside the attribute's range.
• Sounds: playerPlaySound, levelPlaySound, playerStopSound.
• Particles: playerSpawnParticle, levelSpawnParticle.
• C++ (Effects.hpp, Entity, Player, Level), Java (EffectType, Effect, Attribute, Entity, Player, Level) and Wasm (falcon.wit) bindings, README section, and the native and Java examples use them on join.

Compatibility

Every function is appended at the end of FalconServerApi; nothing existing moves or changes. The API version goes to 1.0.6 (header, falcon.wit package, Java artifact, examples), since the patch marks functions added at the end of the table. The server keeps accepting Wasm modules built against @1.0.5 (Falcon side).

The .NET binding is deprecated and not extended; its interop is generated from the header, so it keeps building.

Not added

• Entity scale and reach: the server only applies the scale of entity definitions and has no attribute for reach, so there is nothing to expose without making the behaviour up.

Order

First of the stacked batches. Falcon side: the matching Falcon PR pins this branch.

Checks

CI of this branch: Linux, Windows (MSVC and MinGW), .NET and Java jobs green; the macOS jobs were cancelled by the runner, as on main.