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 state updates, including UGC username/pfp on structs.player
structs.player.*
event-schemas.md#PlayerConsensusEvent
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_consensus GRASS events fire when sync-state commits UGC updates to structs.player. guild_meta fires for off-chain guild config on structs.guild_meta. Chain UGC on structs.guild, structs.planet, and structs.substation surface through chain events and planet_activity.