Version: 1.0.0
Last Updated: 2026-01-16
Description: Complete catalog of GRASS event types and categories
Event Categories
Consensus Events
Event Name
Description
Subject Pattern
Schema
block
Block updates
structs.block.*
event-schemas.md#BlockEvent
Guild Events
Event Name
Description
Subject Pattern
Schema
guild_consensus
Guild consensus data updates
structs.guild.*
event-schemas.md#GuildConsensusEvent
guild_meta
Guild metadata updates
structs.guild.*
event-schemas.md#GuildMetaEvent
guild_membership
Guild membership changes
structs.guild.*
event-schemas.md#GuildMembershipEvent
guild_rank_permission
Guild rank permissions set or revoked
structs.guild.*
event-schemas.md#EventGuildRankPermission
Planet Events
Event Name
Description
Subject Pattern
Schema
raid_status
Raid status changes
structs.planet.*
event-schemas.md#PlanetRaidStatusEvent
planet_activity
Planet activity events from planet_activity table, including struct_health details
structs.planet.*
event-schemas.md#PlanetActivityEvent
fleet_arrive
Fleet arrival
structs.fleet.*
event-schemas.md#FleetArriveEvent
fleet_advance
Fleet advancement
structs.fleet.*
–
fleet_depart
Fleet departure
structs.fleet.*
–
Struct Events
Event Name
Description
Subject Pattern
Schema
struct_attack
Struct attack events
structs.struct.*
–
struct_defense_remove
Defense structure removed
structs.struct.*
–
struct_defense_add
Defense structure added
structs.struct.*
–
struct_defender_clear
Defense relationships cleared from a struct
structs.struct.*
–
struct_status
Struct status changes
structs.struct.*
event-schemas.md#StructStatusEvent
struct_move
Struct movement
structs.struct.*
–
struct_block_build_start
Build operation started
structs.struct.*
–
struct_block_ore_mine_start
Mining operation started
structs.struct.*
–
struct_block_ore_refine_start
Refining operation started
structs.struct.*
–
Player Events
Event Name
Description
Subject Pattern
Schema
player_consensus
Player consensus data updates
structs.player.*
event-schemas.md#PlayerConsensusEvent
player_meta
Player metadata updates
structs.player.*
event-schemas.md#PlayerMetaEvent
Address Events
Event Name
Description
Subject Pattern
address_register
Address registration events
structs.address.register.*
UGC Moderation Events (Cosmos chain events, not GRASS)
ugc_moderated is emitted as a regular Cosmos sdk.Event by the keeper (not by the GRASS DB-trigger pipeline) whenever a UGC name/pfp update is performed by an actor who is not the target object’s owner. Subscribe via Tendermint event subscriptions (tx.events/block_events), not via NATS.
Event Name
Description
Source
Schema
ugc_moderated
A guild moderator overwrote another player’s name/pfp, or the name/pfp of a planet/substation owned by a guild-mate
Cosmos chain event (sdk.Event, type ugc_moderated)
event-schemas.md#UGCModeratedEvent
The chain only emits this event when actor_player_id != target_owner_player_id. Self-service updates (a player renaming themselves, a guild owner renaming their own guild) are silent.
The corresponding player_meta and guild_meta GRASS events also fire (see Player and Guild sections above) when the cache layer commits the new value to the database. Substation and planet UGC changes do not currently emit dedicated GRASS categories.