df.entities.xml

<data-definition>
    <struct-type type-name='entity_occasion_info' original-name='entity_calendarst'>
        <stl-vector name="occasions" pointer-type='entity_occasion' since='v0.42.01'/>
        <int32_t name="next_occasion_id"/>
        <static-array name='events' type-name='int32_t' count='10' ref-target='history_event'/>
        <int32_t name='count' comment="number of elements used in array above"/>
    </struct-type>

    <enum-type type-name='entity_occasion_purpose_type' base-type='int32_t'> bay12: EntityOccasionPurposeType
        <enum-item name='COMMEMORATE_EVENT'/> history_event
        <enum-item name='FAIR'/>
        <enum-item name='GENERAL_HOLY_PERIOD_FOR_FIGURE'/> historical_figure, sphere_type
    </enum-type>

    <struct-type type-name='entity_occasion' original-name='entity_occasion_defst' comment="some festivals are annual, some single time. COMMEMORATE_EVENT without Defunct seems to match with single time, which doesn't make much sense. Only frequency seen is yearly">
        <int32_t name="id"/>
        <bitfield name='flags' base-type='uint32_t'> bay12: ENTITY_OCCASION_FLAG_*
            <flag-bit name='defunct'/>
        </bitfield>
        <int32_t name='site' ref-target='world_site'/>
        <int32_t name='structure' ref-target='abstract_building'/>
        <compound name='name' type-name='language_name'/>
        <int32_t name='start_year_tick'/>
        <int32_t name='end_year_tick'/>
        <enum name='purpose' type-name='entity_occasion_purpose_type'/>
        <int32_t name="purpose_id" init-value='-1' comment='history_event or histfig'/>
        <int32_t name='purpose_subid' init-value='-1' comment='optional sphere'/>
        <stl-vector name='schedule' pointer-type='entity_occasion_schedule'/>

        <pointer name='active_collection' type-name='history_event_collection_occasionst' comment='unsaved, worldgen'/>
    </struct-type>

    <enum-type type-name='occasion_schedule_type' base-type='int32_t'> bay12: EntityOccasionScheduleType
        <enum-item name='DANCE_PERFORMANCE'/> dance form
        <enum-item name='MUSICAL_PERFORMANCE'/> musical form
        <enum-item name='POETRY_RECITAL'/> poetry form
        <enum-item name='STORYTELLING'/> history event
        <enum-item name='DANCE_COMPETITION'/> dance form
        <enum-item name='MUSICAL_COMPETITION'/> musical form
        <enum-item name='POETRY_COMPETITION'/> poetry form
        <enum-item name='FOOT_RACE'/>
        <enum-item name='FLY_RACE'/>
        <enum-item name='MOUNTED_RACE'/> race, caste
        <enum-item name='WRESTLING_COMPETITION'/>
        <enum-item name='THROWING_COMPETITION'/> item type, subtype, material, matgloss
        <enum-item name='GLADIATORY_COMPETITION'/>
        <enum-item name='PROCESSION'/> start abstract building, end abstract building
        <enum-item name='CEREMONY'/>
    </enum-type>

    <struct-type type-name='entity_occasion_schedule' original-name='entity_occasion_schedulest'>
        <enum name='type' type-name='occasion_schedule_type'/>
        <int32_t name='reference' comment="art form / event / item_type /procession start abstract building"/>
        <int32_t name='reference2' comment="item_subtype / procession stop abstract building"/>
        <int32_t name='reference3' comment='material'/>
        <int32_t name='reference4' comment='matgloss'/>
        <bitfield name='flags' base-type='uint32_t'> bay12: ENTITY_OCCASION_SCHEDULE_FLAG_*
            <flag-bit name='group_or_troupe'/>
        </bitfield>
        <stl-vector name='features' pointer-type='entity_occasion_schedule_feature' />
        <int32_t name='start_year_tick'/>
        <int32_t name='end_year_tick'/>
    </struct-type>

    <enum-type type-name='occasion_schedule_feature' base-type='int32_t'> bay12: EntityOccasionScheduleElementType
        <enum-item name='ANIMALS_ACCOMPANYING'/> race, caste
        <enum-item name='ANIMALS_MOUNTED'/> race, caste
        <enum-item name='STORYTELLING'/> history event
        <enum-item name='POETRY_RECITAL'/> poetry form
        <enum-item name='MUSICAL_PERFORMANCE'/> musical form
        <enum-item name='DANCE_PERFORMANCE'/> dance form
        <enum-item name='MOVING_PERFORMANCE_STAGE'/>
        <enum-item name='CRIERS_IN_FRONT'/>
        <enum-item name='ORDER_OF_PRECEDENCE'/>
        <enum-item name='BANNERS'/>
        <enum-item name='IMAGES'/> histfig
        <enum-item name='FLOWERS_CARRIED'/> plant id, growth idx
        <enum-item name='FLOWERS_SCATTERED'/> plant id, growth idx
        <enum-item name='ACROBATS'/>
        <enum-item name='INCENSE_BURNING'/>
        <enum-item name='COSTUMES'/>
        <enum-item name='CANDLES'/>
        <enum-item name='THE_GIVING_OF_ITEMS'/> item type, item subtype, material, matgloss
        <enum-item name='THE_SACRIFICE_OF_ITEMS'/> item type, item subtype, material, matgloss
        <enum-item name='THE_SACRIFICE_OF_CREATURES'/> race, caste
        <enum-item name='THE_SACRIFICE_OF_PLANTS'/> plant id
    </enum-type>

    <struct-type type-name='entity_occasion_schedule_feature' original-name='eos_elementst'>
        <enum name='feature' base-type='int32_t' type-name='occasion_schedule_feature'/>
        <int32_t name='reference' />
        <int32_t name='reference2'/>
        <int32_t name='reference3'/>
        <int32_t name='reference4'/>
    </struct-type>

    <struct-type type-name='entity_activity_statistics' original-name='reportst'>
        <compound name='food'> not a compound
            <int32_t name='total'/>
            <int32_t name='meat'/>
            <int32_t name='fish'/>
            <int32_t name='other'/>
            <int32_t name='seeds'/>
            <int32_t name='plant'/>
            <int32_t name='drink'/>
        </compound>
        <static-array name='unit_counts' type-name='int16_t' count='152' index-enum='profession'/>
        <int16_t name='population'/>
        <int16_t name='menial_exempt'/>
        <int16_t name='omnivores'/>
        <int16_t name='carnivores'/>
        <int16_t name='trained_animals'/>
        <int16_t name='other_animals'/>
        <int16_t name='potential_soldiers'/>
        <int32_t name='combat_aptitude'/>
        <static-array name='item_counts' type-name='int32_t' count='113' index-enum='item_type'/>
        <stl-vector name='created_weapons' type-name='int32_t' index-refers-to='$global.world.raws.itemdefs.weapons[$]'/>
        <compound name='wealth'> not a compound
            <int32_t name='total'/>
            <int32_t name='weapons'/>
            <int32_t name='armor'/>
            <int32_t name='furniture'/>
            <int32_t name='other'/>
            <int32_t name='architecture'/>
            <int32_t name='displayed'/>
            <int32_t name='held'/>
            <int32_t name='imported'/>
            <int32_t name='offered'/>
            <int32_t name='exported'/>
        </compound>
        <static-array name='recent_jobs' count='7'> creature, all, glass, stone, metal, tree, shrub
            <static-array count='258' type-name='int32_t' index-enum='job_type'/>
        </static-array>
        <int32_t name='excavated_tiles' comment='unhidden, subterranean, and excluding map features'/>
        <static-array count='5' type-name='int32_t' name='death_history'/>
        <static-array count='5' type-name='int32_t' name='insanity_history'/>
        <static-array count='5' type-name='int32_t' name='execution_history'/>
        <static-array count='5' type-name='int32_t' name='noble_death_history'/>
        <int32_t name='total_deaths'/>
        <int32_t name='total_insanities'/>
        <int32_t name='total_executions'/>
        <static-array count='4' type-name='int32_t' name='happiness_number'/>
        <int32_t name='num_artifacts'/>
        <int32_t name='invaders_repelled'/>
        <!-- <compound name='knowledge'> --> bay12: knowledgest
        <stl-vector name='discovered_creature_foods' type-name='bool' index-refers-to='(find-creature $)'/>
        <stl-vector name='discovered_creatures' type-name='bool' index-refers-to='(find-creature $)'/>
        <stl-vector name='discovered_plant_foods' type-name='bool' index-refers-to='(find-plant-raw $)'/>
        <stl-vector name='discovered_plants' type-name='bool' index-refers-to='(find-plant-raw $)' comment='allows planting of seeds'/>
        <!-- </compound> -->
        <int16_t name='discovered_water_features'/>
        <int16_t name='discovered_subterranean_features'/>
        <int16_t name='discovered_chasm_features'/>
        <int16_t name='discovered_magma_features'/>
        <int16_t name='discovered_underworld_features'/>
        <int32_t name='migrant_wave_idx' comment='age_in_years'/>
        <stl-vector name='found_minerals' type-name='int32_t' ref-target='inorganic_raw'
                    comment="Added after 'you have struck' announcement"/>
        <bitfield name='found_misc' base-type='uint32_t'> bay12: REPORT_SITE_FLAG_*
            <flag-bit name='deep_special'/>
        </bitfield>
    </struct-type>

    <struct-type type-name='tradegoodslistst'>
        <pointer name='it' type-name='item'/>
        <int32_t name='dist'/>
        <int8_t name='tag'/>
        <bool name='prohibited'/>
        <int32_t name='value'/>
        <bool name='expanded_container'/>
        <int32_t name='container_amount'/>
        <int32_t name='sort_value'/>
    </struct-type>

    <struct-type type-name='assign_trade_itemlistst'>
        <stl-vector name='tgi' pointer-type='tradegoodslistst'/>
    </struct-type>

    <struct-type type-name='abstractitemlistst'>
        <stl-vector name='type' type-name='int16_t'/>
        <stl-vector name='subtype' type-name='int16_t'/>
        <stl-vector name='subcat1' type-name='int16_t'/>
        <stl-vector name='subcat2' type-name='int16_t'/>
        <stl-vector name='amount' type-name='int32_t'/>
        <stl-bit-vector name='expanded'/>
    </struct-type>

    <struct-type type-name='itemlistst'>
        <stl-vector name='l_item' pointer-type='item'/>
    </struct-type>

    <struct-type type-name='caravan_state' original-name='plot_merchantst'>
        <compound name='total_capacity' type-name='massst'/>
        <enum name='trade_state' base-type='int8_t' comment='bay12: stage'>
            <enum-item name='None'/>
            <enum-item name='Approaching'/>
            <enum-item name='AtDepot'/>
            <enum-item name='Leaving'/>
            <enum-item name='Stuck'/>
        </enum>
        <int8_t name='depot_notified' comment='bay12: havecomplained; has it warned you that you need a depot'/>
        <int16_t name='time_remaining' comment='bay12: timer'/>
        <int32_t name='entity' ref-target='historical_entity'/>
        <compound name='activity_stats' type-name='entity_activity_statistics' comment='bay12: report'/>
        <bitfield name='flags' base-type='uint32_t'> bay12: MERCHANTEVENTFLAG_*
            <flag-bit name='check_cleanup' comment='CHECKANDFINALIZE; set each time a merchant leaves the map or dies'/>
            <flag-bit name='casualty' comment='JUSTSPOILED'/>
            <flag-bit name='hardship' comment='WENTBADLY'/>
            <flag-bit name='communicate' comment='SOMEBODYLIVED; send data to mountainhomes'/>
            <flag-bit name='seized' comment='GOODSSEIZED'/>
            <flag-bit name='offended' comment='NOMORETRADE'/>
            <flag-bit comment='UNUSED_07'/>
            <flag-bit name='greatly_offended' comment='OFFENDED'/>
            <flag-bit name='tribute' comment='IS_TRIBUTE_CARAVAN; caravan is delivering tribute (not merchant caravan)'/>
        </bitfield>
        <int32_t name='import_value' comment='bay12: goodsvalue_initial'/>
        <int32_t name='export_value_total' comment='bay12: goodsvalue_end'/>
        <int32_t name='export_value_personal' comment='bay12: exportvalue_end; excluding foreign-produced items'/>
        <int32_t name='offer_value' comment='bay12: offervalue_end'/>
        <stl-vector name='animals' comment='bay12: unitroster' type-name='int32_t' ref-target='unit'/>
        <pointer type-name='entity_sell_prices' name='sell_prices' comment='bay12: tradeagreement'/>
        <pointer type-name='entity_buy_prices' name='buy_prices' comment='bay12: requestagreement'/>
        <stl-vector name='goods' type-name='int32_t' ref-target='item' comment='bay12: already_appraised_item_id'/>
        <int32_t name='mood' init-value='50' comment='bay12: tolerance; reflects satisfaction with last trading session'/>
        <int32_t name='haggle_fail_count'/>
    </struct-type>

    <struct-type type-name='entity_buy_prices' original-name='civ_requestagreementst'>
        <pointer type-name='entity_buy_requests' name='items'/>
        <stl-vector type-name='int32_t' name='price'/>
    </struct-type>

    <struct-type type-name='entity_buy_requests' original-name='civgoods_requestst'>
        <stl-vector name='item_type' comment='guess'>
            <enum base-type='int16_t' type-name='item_type'/>
        </stl-vector>
        <stl-vector name="item_subtype" comment='guess'>
            <int16_t refers-to='(item-subtype-target $$._global.item_type[$$._key] $)'/>
        </stl-vector>
        <stl-vector name='mat_types'>
            <int16_t ref-target='material' aux-value='$$._parent.mat_indices[$._key]'/>
        </stl-vector>
        <stl-vector name='mat_indices' type-name='int16_t'/>
        <stl-vector name="mat_cats" type-name='job_material_category'/>
        <stl-vector type-name='int8_t' name='priority'/>
    </struct-type>

    <enum-type type-name='entity_sell_category' base-type='int16_t'> bay12: CivRequestTabType
        <enum-item name='Leather'/>
        <enum-item name='ClothPlant'/>
        <enum-item name='ClothSilk'/>
        <enum-item name='Crafts'/>
        <enum-item name='Wood'/>
        <enum-item name='MetalBars'/>
        <enum-item name='SmallCutGems'/>
        <enum-item name='LargeCutGems'/>
        <enum-item name='StoneBlocks'/>
        <enum-item name='Seeds'/>
        <enum-item name='Anvils'/>
        <enum-item name='Weapons'/>
        <enum-item name='TrainingWeapons'/>
        <enum-item name='Ammo'/>
        <enum-item name='TrapComponents'/>
        <enum-item name='DiggingImplements'/>
        <enum-item name='Bodywear'/>
        <enum-item name='Headwear'/>
        <enum-item name='Handwear'/>
        <enum-item name='Footwear'/>
        <enum-item name='Legwear'/>
        <enum-item name='Shields'/>
        <enum-item name='Toys'/>
        <enum-item name='Instruments'/>
        <enum-item name='Pets'/>
        <enum-item name='Drinks'/>
        <enum-item name='Cheese'/>
        <enum-item name='Powders'/>
        <enum-item name='Extracts'/>
        <enum-item name='Meat'/>
        <enum-item name='Fish'/>
        <enum-item name='Plants'/>
        <enum-item name='FruitsNuts'/>
        <enum-item name='GardenVegetables'/>
        <enum-item name='MeatFishRecipes'/>
        <enum-item name='OtherRecipes'/>
        <enum-item name='Stone'/>
        <enum-item name='Cages'/>
        <enum-item name='BagsLeather'/>
        <enum-item name='BagsPlant'/>
        <enum-item name='BagsSilk'/>
        <enum-item name='ThreadPlant'/>
        <enum-item name='ThreadSilk'/>
        <enum-item name='RopesPlant'/>
        <enum-item name='RopesSilk'/>
        <enum-item name='Barrels'/>
        <enum-item name='FlasksWaterskins'/>
        <enum-item name='Quivers'/>
        <enum-item name='Backpacks'/>
        <enum-item name='Sand'/>
        <enum-item name='Glass'/>
        <enum-item name='Miscellaneous'/>
        <enum-item name='Buckets'/>
        <enum-item name='Splints'/>
        <enum-item name='Crutches'/>
        <enum-item name='Eggs'/>
        <enum-item name='BagsYarn'/>
        <enum-item name='RopesYarn'/>
        <enum-item name='ClothYarn'/>
        <enum-item name='ThreadYarn'/>
        <enum-item name='Tools'/>
        <enum-item name='Clay'/>
        <enum-item name='Parchment'/>
        <enum-item name='CupsMugsGoblets'/>
    </enum-type>

    <struct-type type-name='entity_sell_prices' original-name='civ_tradeagreementst'>
        <pointer type-name='entity_sell_requests' name='items'/>
        <static-array count='107' index-enum='entity_sell_category' name='price'>
            <stl-vector type-name='int32_t'/>
        </static-array>
    </struct-type>

    <struct-type type-name='entity_sell_requests' original-name='civgoods_demandst'>
        <static-array count='107' index-enum='entity_sell_category' name='priority'>
            <stl-vector type-name='int8_t'/>
        </static-array>
    </struct-type>

    <struct-type type-name='entity_recipe' original-name='civ_recipest'>
        <int16_t name='subtype' ref-target='itemdef_foodst'/>
        <stl-vector name='item_types'>
            <enum base-type='int16_t' type-name='item_type'/>
        </stl-vector>
        <stl-vector name='item_subtypes'>
            <int16_t name='item_subtype' refers-to='(item-subtype-target $$._parent._parent.item_types[$$._key] $)'/>
        </stl-vector>
        <stl-vector name='mat_types'>
            <int16_t ref-target='material' aux-value='$$._parent.mat_indices[$._key]'/>
        </stl-vector>
        <stl-vector name='mat_indices' type-name='int16_t'/> yes, actually int16 even though matgloss should be int32
    </struct-type>

    <enum-type type-name='historical_entity_type' base-type='int16_t'> bay12: EntityType
        <enum-item name='Civilization'/>
        <enum-item name='SiteGovernment'/>
        <enum-item name='VesselCrew'/>
        <enum-item name='MigratingGroup'/>
        <enum-item name='NomadicGroup'/>
        <enum-item name='Religion'/>
        <enum-item name='MilitaryUnit'/>
        <enum-item name='Outcast'/>
        <enum-item name='PerformanceTroupe'/>
        <enum-item name='MerchantCompany'/>
        <enum-item name='Guild'/>
    </enum-type>

    <struct-type type-name='honors_type' original-name='entity_honorst' key-field='id'>
        <int32_t name='id'/>
        <bitfield name='flags' base-type='uint32_t'> bay12: ENTITY_HONOR_FLAG_*
            <flag-bit name='granted_to_all_new_members'/>
        </bitfield>
        <stl-string name='name'/>
        <int32_t name='precedence_awarded'/>
        <enum name='required_skill' type-name='job_skill' base-type='int16_t'/>
        <bitfield name='required_skill_type'> bay12: ENTITY_HONOR_REQUIRED_SKILL_FLAG_*
            <flag-bit name='melee_weapon'/>
            <flag-bit name='ranged_weapon'/>
        </bitfield>
        <int32_t name='required_skill_points'/>
        <int32_t name='required_kills'/>
        <int32_t name='required_battles'/>
        <int32_t name='required_years_of_membership'/>
        <stl-vector name='honored' type-name='int32_t' ref-target='historical_figure'/>
        <stl-vector name='required_position' type-name='int32_t' ref-target='entity_position'/>
        <stl-vector name='required_former_position' type-name='int32_t' ref-target='entity_position'/>
    </struct-type>

    <struct-type type-name='artifact_claim' original-name='entity_artifact_claimst'>
        <int32_t name='artifact_id' ref-target='artifact_record'/>
        <enum name='claim_type' base-type='int32_t' type-name='artifact_claim_type'/>
        <int32_t name='symbol_claim_id' init-value='-1' comment='refers to entity_position_assignment'/>
        <int32_t name='claim_year' init-value='-1' comment="Written contents often seem to lack info of being claimed"/>
        <int32_t name='claim_year_tick' init-value='-1' comment="usually init"/>
        <int32_t name='renounce_event' ref-target='history_event'/>

        <!-- <compound name='temp_arl'> --> bay12: artifact_rumor_locationst
        <pointer name='artifact' type-name='artifact_record'/>
        <int32_t name='site' ref-target='world_site'/>
        <int32_t name='structure_local' init-value='-1'/>
        <int32_t name='holder_hf' ref-target='historical_figure' comment="might be owner_hf. all cases encountered have had both field the same when claimed by entity"/>
        <int32_t name='subregion' ref-target='world_region'/>
        <int32_t name='feature_layer_id' ref-target='world_underground_region'/>
        <int32_t name='latest_year' init-value='-1'/>
        <int32_t name='latest_season_tick' init-value='-1'/>
        <uint32_t name='flags'/>
        <pointer name='witness' type-name='witness_incidentst'/>
        <!-- </compound> -->

        <pointer name='temp_site_ent' type-name='historical_entity' has-bad-pointers='true'/>
        <pointer name='temp_civ_ent' type-name='historical_entity' has-bad-pointers='true'/>
    </struct-type>

    <struct-type type-name='evidence_hf_filest'>
        <int32_t name='hfid' ref-target='historical_figure'/>
        <bitfield name='flags' base-type='uint32_t'> bay12: EVIDENCE_HF_FILE_FLAG_*
            <flag-bit name='have_new_general_evidence'/>
            <flag-bit name='have_new_untested_evidence'/>
            <flag-bit name='under_surveillance'/>
            <flag-bit name='basic_name_attached_to_visual'/>
        </bitfield>
        <stl-vector name='evidence' type-name='int32_t'/>
        <stl-vector name='agreement' type-name='int32_t' ref-target='agreement'/>
        <stl-vector name='evidence_flag' type-name='uint32_t' comment='1 = TESTED_BY_INTERROGATION'/> bay12: EVIDENCE_FLAG_
        <stl-vector name='wanted_crime' type-name='int32_t'/> bay12: CrimeType, currently defined inline in crime
        <stl-vector name='wanted_crime_agreement' type-name='int32_t'  ref-target='agreement'/>
        <stl-vector name='used_identity' type-name='int32_t' ref-target='identity'/>
        <bitfield name='temp_flags' base-type='uint32_t'> bay12: EVIDENCE_HF_FILE_TEMP_FLAG_*
            <flag-bit name='has_master'/>
            <flag-bit name='has_org_association'/>
        </bitfield>
    </struct-type>

    <struct-type type-name='evidence_repositoryst'>
        <stl-vector name='hf_file' pointer-type='evidence_hf_filest'/>
        <stl-vector name='foiled_plot_agreements' type-name='int32_t' ref-target='agreement' comment="all known agreements"/>
        <stl-vector name='known_events' type-name='int32_t' ref-target='history_event'/>

        <bitfield name='flags' since='v0.34.01'> bay12: EVIDENCE_REPOSITORY_FLAG_*
            <flag-bit name='have_wanted_hf'/>
        </bitfield>
    </struct-type>

    <struct-type type-name='entity_pop_specifierst'>
        <int32_t name='race'/>
        <int32_t name='epid'/>
        <int32_t name='special_controlling_enid'/>
        <int32_t name='breed_id'/>
        <int32_t name='cultural_identity_id'/>
        <int32_t name='interaction_index'/>
        <int32_t name='interaction_effect_index'/>
        <int32_t name='squad_id'/>
        <int32_t name='squad_epp_id'/>
        <int32_t name='wg_culture_reference_enid'/>
    </struct-type>

    <struct-type type-name='world_gen_entity_populationst'>
        <int32_t name='num'/>
        <compound type-name='entity_pop_specifierst' name='pop_spec'/>
    </struct-type>

    <struct-type type-name='world_gen_wandering_groupst'>
        <stl-vector pointer-type='historical_figure' name='wanderer'/>
        <stl-vector pointer-type='world_gen_entity_populationst' name='ent_pop'/>
        <stl-vector pointer-type='world_population' name='rpop'/>
        <pointer type-name='historical_entity' name='ent'/>
        <pointer type-name='world_site' name='cur_location'/>
        <pointer type-name='world_region' name='cur_location_sr'/>
        <pointer type-name='world_underground_region' name='cur_location_fl'/>
        <int32_t name='relocate_delay'/>
        <pointer type-name='wg_site_culturest' name='wg_site_culture'/>
    </struct-type>

    <struct-type type-name='historical_entity' key-field='id'
                 instance-vector='$global.world.entities.all'
                 original-name='entityst'>
        <enum name='type' base-type='int16_t' type-name='historical_entity_type'/>
        <int32_t name='id' comment='index in the array'/>

        <pointer name='entity_raw' type-name='entity_raw'/>
        <int32_t name='source_hfid' ref-target='historical_figure'/>

        <int32_t name='save_file_id' comment='changes once has 100 entries'/>
        <int16_t name='next_member_idx'/>

        <compound name='name' type-name='language_name'/>

        <code-helper name='describe'>
            $.type
            (describe-obj (find-creature $.race))
            (describe-obj $.name)
        </code-helper>

        <int16_t name='race' ref-target='creature_raw'/>

        <bitfield name='flags' base-type='uint32_t'> bay12: ENTITYFLAG_*
            <flag-bit name='neighbor' comment="NEARBY"/>
            <flag-bit name='player_civ' comment="VISIBLE"/>
            <flag-bit name='make_nems_check_positions'/>
            <flag-bit name='discovered'/>
            <flag-bit name='dead'/>
                SiteGovernment and Outcast has this flag set when there are no site links with the residence or invasion_push_out
                flag set. Others (NomadicGroup, MilitaryUnit seen) have it set when the criteria of the first group are fullfilled
                together with occupation_failed, criminal_gang, and reclaim being absent as well, provided they have at least one
                site link (no site link = flag not set).
                Civilizations can have the flag set when having lost all sites, but usually do not, so the flag seems useless
                at that level (Some exterminated kobolds have it set, while most do not, for instance. Embark culled dwarven civs
                may or may not have it set).
            <flag-bit name='secret'/>
            <flag-bit name='possible_evaluate_position_profile'/>
            <flag-bit name='possible_succession_position_profile'/>
            <flag-bit name='possible_appointable_position_profile'/>
            <flag-bit name='possible_elected_position_profile'/>
            <flag-bit name='unspecific_race'/>
            <flag-bit name='evaluate_position_profile_activity'/>
            <flag-bit name='has_poetry_for_trav_poets'/>
            <flag-bit name='has_music_for_trav_bards'/>
            <flag-bit name='has_dance_for_trav_dancers'/>
            <flag-bit name='trav_bards_get_sing'/>
            <flag-bit name='trav_bards_get_keyboard_instrument'/>
            <flag-bit name='trav_bards_get_stringed_instrument'/>
            <flag-bit name='trav_bards_get_wind_instrument'/>
            <flag-bit name='trav_bards_get_percussion_instrument'/>
            <flag-bit name='trav_bards_get_speaking'/>
            <flag-bit name='have_art_pointers'/>
            <flag-bit name='isolated'/>
            <flag-bit name='ignore_siege_triggers'/>
            <flag-bit name='calculated_best_appointment_precedence'/>
            <flag-bit name='religious_devotion'/>
            <flag-bit name='might_have_interaction_region_pops'/>
        </bitfield>

        <stl-vector name='guild_professions' since='v0.47.01' comment="Only seen 1, and only for guilds">
            <pointer> bay12: entity_focusst
                <enum name='type'><enum-item name='PROMOTE_PROFESSION_UNIT'/></enum>
                <enum name='profession' base-type='int32_t' type-name='profession'/>
            </pointer>
        </stl-vector>
        <stl-vector name='entity_links' pointer-type='entity_entity_link'/>
        <stl-vector name='site_links' pointer-type='entity_site_link'/>

        <stl-vector name='histfig_ids' type-name='int32_t' ref-target='historical_figure'/>

        <stl-vector name='populations' type-name='int32_t' ref-target='entity_population'
                    comment='1st entry copies to unit.population_id for Adventurer?'/>

        <stl-vector name='nemesis_ids' type-name='int32_t' ref-target='nemesis_record'/>

        <compound name='resources'> not a compound, nor are any of the compounds inside
            <stl-vector name='digger_type' type-name='int16_t' ref-target='itemdef_weaponst'/>
            <stl-vector name='weapon_type' type-name='int16_t' ref-target='itemdef_weaponst'/>
            <stl-vector name='training_weapon_type' type-name='int16_t' ref-target='itemdef_weaponst'/>
            <stl-vector name='armor_type' type-name='int16_t' ref-target='itemdef_armorst'/>
            <stl-vector name='ammo_type' type-name='int16_t' ref-target='itemdef_ammost'/>
            <stl-vector name='helm_type' type-name='int16_t' ref-target='itemdef_helmst'/>
            <stl-vector name='gloves_type' type-name='int16_t' ref-target='itemdef_glovesst'/>
            <stl-vector name='shoes_type' type-name='int16_t' ref-target='itemdef_shoesst'/>
            <stl-vector name='pants_type' type-name='int16_t' ref-target='itemdef_pantsst'/>
            <stl-vector name='shield_type' type-name='int16_t' ref-target='itemdef_shieldst'/>
            <stl-vector name='trapcomp_type' type-name='int16_t' ref-target='itemdef_trapcompst'/>
            <stl-vector name='toy_type' type-name='int16_t' ref-target='itemdef_toyst'/>
            <stl-vector name='instrument_type' type-name='int16_t' ref-target='itemdef_instrumentst'/>
            <stl-vector name='siegeammo_type' type-name='int16_t' ref-target='itemdef_siegeammost'/>
            <stl-vector name='tool_type' type-name='int16_t' ref-target='itemdef_toolst'/>
            <stl-vector name='reaction_idx' type-name='int32_t' ref-target='reaction' since='v0.42.01'/>

            <compound name='metal'>
                <compound name='pick' type-name='material_vec_ref'/>
                <compound name='weapon' type-name='material_vec_ref'/>
                <compound name='ranged' type-name='material_vec_ref'/>
                <compound name='ammo' type-name='material_vec_ref'/>
                <compound name='ammo_metal' type-name='material_vec_ref'/>
                <compound name='armor' type-name='material_vec_ref' comment='also instruments, toys, and tools'/>
                <compound name='anvil' type-name='material_vec_ref'/>
            </compound>

            <compound name='organic'>
                <compound name='leather' type-name='material_vec_ref'/>
                <compound name='parchment' type-name='material_vec_ref' since='v0.42.01'/>
                <compound name='fiber' type-name='material_vec_ref'/>
                <compound name='silk' type-name='material_vec_ref'/>
                <compound name='wool' type-name='material_vec_ref'/>
                <compound name='wood' type-name='material_vec_ref'/>
            </compound>

            <stl-vector name='metals' type-name='int32_t' ref-target='inorganic_raw' comment='bars'/>
            <stl-vector name='stones' type-name='int32_t' ref-target='inorganic_raw' comment='boulders and blocks'/>
            <stl-vector name='gems' type-name='int32_t' ref-target='inorganic_raw' comment='small and large cut'/>

            <compound name='refuse'>
                <compound name='bone' type-name='material_vec_ref'/>
                <compound name='shell' type-name='material_vec_ref'/>
                <compound name='pearl' type-name='material_vec_ref'/>
                <compound name='ivory' type-name='material_vec_ref'/>
                <compound name='horn' type-name='material_vec_ref'/>
            </compound>

            <compound name='misc_mat'>
                <compound name='others' type-name='material_vec_ref' comment='amber and coral'/>
                <compound name='glass' type-name='material_vec_ref'/>
                <compound name='sand' type-name='material_vec_ref'/>
                <compound name='clay' type-name='material_vec_ref'/>
                <compound name='crafts' type-name='material_vec_ref'/>
                <compound name='vials' type-name='material_vec_ref'/>
                <compound name='barrels' type-name='material_vec_ref' comment='also buckets, splints, and crutches'/>
                <compound name='flasks' type-name='material_vec_ref'/>
                <compound name='quivers' type-name='material_vec_ref'/>
                <compound name='backpacks' type-name='material_vec_ref'/>
                <compound name='cages' type-name='material_vec_ref'/>
                <compound name='temp_furniture' type-name='material_vec_ref' since='v0.34.01'/>
                <compound name='perm_furniture' type-name='material_vec_ref' since='v0.34.01'/>
                <compound name='booze' type-name='material_vec_ref'/>
                <compound name='cheese' type-name='material_vec_ref'/>
                <compound name='powders' type-name='material_vec_ref'/>
                <compound name='extracts' type-name='material_vec_ref'/>
                <compound name='meat' type-name='material_vec_ref'/>
            </compound>

            <stl-vector name='fish_races' type-name='int32_t' ref-target='creature_raw'/>
            <stl-vector name='fish_castes' type-name='int16_t' ref-target='caste_raw' aux-value='$$._parent.fish_races[$._key]'/>

            <stl-vector name='egg_races' type-name='int32_t' ref-target='creature_raw'/>
            <stl-vector name='egg_castes' type-name='int16_t' ref-target='caste_raw' aux-value='$$._parent.egg_races[$._key]'/>

            <compound name='plants' type-name='material_vec_ref'/>

            <stl-vector name='tree_fruit_plants' type-name='int32_t' ref-target='plant_raw'/>
            <stl-vector name='tree_fruit_growths' type-name='int16_t' ref-target='plant_growth' aux-value='$$._parent.tree_fruit_plants[$._key]'/>

            <stl-vector name='shrub_fruit_plants' type-name='int32_t' ref-target='plant_raw'/>
            <stl-vector name='shrub_fruit_growths' type-name='int16_t' ref-target='plant_growth' aux-value='$$._parent.shrub_fruit_plants[$._key]'/>

            <compound name='seeds' type-name='material_vec_ref'/>

            <compound name='wood_products' comment='lye, charcoal, potash, pearlash, and coke'>
                <stl-vector name='item_type'>
                    <enum base-type='int16_t' type-name='item_type'/>
                </stl-vector>
                <stl-vector type-name='int16_t' name='item_subtype'/>
                <compound name='material' type-name='material_vec_ref'/>
            </compound>

            <compound name='animals'>
                <stl-vector name='pet_races' type-name='int32_t' ref-target='creature_raw'/>
                <stl-vector name='wagon_races' type-name='int32_t' ref-target='creature_raw'/>
                <stl-vector name='pack_animal_races' type-name='int32_t' ref-target='creature_raw'/>
                <stl-vector name='wagon_puller_races' type-name='int32_t' ref-target='creature_raw'/>
                <stl-vector name='mount_races' type-name='int32_t' ref-target='creature_raw'/>
                <stl-vector name='minion_races' type-name='int32_t' ref-target='creature_raw'/>
                <stl-vector name='exotic_pet_races' type-name='int32_t' ref-target='creature_raw'/>

                <stl-vector name='pet_castes' type-name='int16_t' ref-target='caste_raw' aux-value='$$._parent.pet_races[$._key]'/>
                <stl-vector name='wagon_castes' type-name='int16_t' ref-target='caste_raw' aux-value='$$._parent.wagon_races[$._key]'/>
                <stl-vector name='pack_animal_castes' type-name='int16_t' ref-target='caste_raw' aux-value='$$._parent.pack_animal_races[$._key]'/>
                <stl-vector name='wagon_puller_castes' type-name='int16_t' ref-target='caste_raw' aux-value='$$._parent.wagon_puller_races[$._key]'/>
                <stl-vector name='mount_castes' type-name='int16_t' ref-target='caste_raw' aux-value='$$._parent.mount_races[$._key]'/>
                <stl-vector name='minion_castes' type-name='int16_t' ref-target='caste_raw' aux-value='$$._parent.minion_races[$._key]'/>
                <stl-vector name='exotic_pet_castes' type-name='int16_t' ref-target='caste_raw' aux-value='$$._parent.unk728_races[$._key]'/>
            </compound>

            <stl-vector name='meat_fish_recipes' pointer-type='entity_recipe'/>
            <stl-vector name='other_recipes' pointer-type='entity_recipe'/>

            <static-array name='soldier_mats' count='3' comment='melee, archer1, archer - unused?'>
                <int16_t name='mat_type' init-value='-1'/>
                <int32_t name='mat_index'/>
            </static-array>

            <stl-vector name='traded' pointer-type='item' comment='never used, items would be equipped by arriving King'/>

            <int16_t name='min_temperature'/>
            <int16_t name='max_temperature'/>

            <static-array name='ethic' count='22' index-enum='ethic_type'>
                <enum base-type='int16_t' type-name='ethic_response'/>
            </static-array>

            <static-array name='values' type-name='int32_t' count='64' index-enum='value_type'/>

            <uint32_t name='scholar_flag' since='v0.42.01'/> likely ENTITY_SCHOLAR_FLAG_*
            <static-array name='permitted_skill' type-name='bool' index-enum='job_skill' count='149'/>

            <stl-vector type-name='int16_t' name='art_image_types' comment='0 = civilization symbol, 1 = commissioned'/>
            <stl-vector type-name='int32_t' name='art_image_ids'/>
            <stl-vector type-name='int16_t' name='art_image_subids'/>
            <stl-vector name='art_image_char' type-name='uint8_t'/>
            <stl-vector name='foreground_color_curses'>
                <enum type-name='curses_color' base-type='int8_t'/>
            </stl-vector>
            <stl-vector name='background_color_curses'>
                <enum type-name='curses_color' base-type='int8_t'/>
            </stl-vector>
            <stl-vector name='foreground_color_curses_bright' type-name='bool'/>
            <stl-vector name='foreground_color' type-name='int16_t' ref-target='descriptor_color' comment="foreground color used for the entity symbol in legends mode and the historical maps."/>
            <stl-vector name='background_color' type-name='int16_t' ref-target='descriptor_color' comment="background color used for the entity symbol in legends mode and the historical maps."/>
        </compound>

        <stl-vector name='uniforms' pointer-type='entity_uniform'/>
        <int32_t name='next_uniform_id'/>

        <compound name='relations'> not a compound
            <stl-vector name='known_sites' type-name='int32_t' ref-target='world_site' comment="only civs and site government. Fresh player site government has empty vector"/>
            <stl-vector name='deities' type-name='int32_t' ref-target='historical_figure'/>
            <stl-vector name='worship' type-name='int32_t' comment="worship acceptability"/>
            <stl-vector name='belief_systems' type-name='int32_t' ref-target="belief_system" comment="In Religion type entities established by prophets after having developed their own belief system, the ID of this belief system is contained here."/>
            <stl-vector name='constructions' comment="only civs. Usually pairs for source/destination, with destination lacking path and construction. Construction and second entry can be lacking when destination lost(construction destroyed as well?). Also seen only source entry">
                <pointer> bay12: transport_linkst
                    <compound name='path' type-name='coord2d_path' comment="set only for the first source/destination/construction entry in pairs"/>
                    <int32_t name='source_site' ref-target='world_site'/>
                    <int32_t name='destination_site' ref-target='world_site'/>
                    <stl-vector name='construction' ref-target='construction' type-name='int32_t' comment="set only for the first (source) entry in pairs"/>
                    <int16_t name='desired_level'/>
                    <int16_t name='attained_level'/>
                </pointer>
            </stl-vector>

            bay12: diplomacy_datast
            <stl-vector name='diplomacy'> sorted by group_id
                <pointer> bay12: diplomacy_statest
                    <int32_t name='group_id' ref-target='historical_entity'/>
                    <enum name='relation' base-type='int16_t'> bay12: DiplomacyStateType
                        <enum-item name='Peace'/>
                        <enum-item name='TotalWar'/>
                        <enum-item name='NoContact'/>
                        <enum-item name='AcceptingTribute'/>
                        <enum-item name='OfferingTribute'/>
                        <enum-item name='Skirmishing'/>
                    </enum>
                    <int32_t name='war_event_collection' ref-target='history_event_collection'/>
                    <stl-vector name='historic_events' type-name='int32_t' ref-target='history_event'/>
                    <stl-vector name='historic_events_collection' type-name='int32_t' ref-target='history_event_collection' comment="seen with war_event_collection set"/>
                    <bitfield name='flags' base-type='uint32_t'> bay12: DIPLOMACY_STATE_FLAG_*
                        <flag-bit name='peace_offering_made'/>
                        <flag-bit name='peace_offering_received'/>
                        <flag-bit name='allies'/>
                    </bitfield>
                    <enum base-type='int32_t' type-name='season' name='tribute_season'/>
                </pointer>
            </stl-vector>

            <int16_t name='search_for_site_timer' init-value='0'/>
            <stl-vector name='death_trap_x' type-name='int16_t'/>
            <stl-vector name='death_trap_y' type-name='int16_t'/>
            <stl-vector name='death_trap_timer' type-name='int32_t'/>
            <stl-vector name='succession_position' type-name='int32_t' comment="position index (not id)"/>
            <stl-vector name='succession_old_hf' type-name='int32_t' ref-target='historical_figure' comment="holder of office of corresponding position index"/>
        </compound>

        <compound name='positions'> not a compound
            <stl-vector name='own' pointer-type='entity_position'/>
            <stl-vector name='site' pointer-type='entity_position'/>
            <stl-vector name='conquered_site' pointer-type='entity_position'/>

            <int32_t name='next_position_id'/>

            <stl-vector name='assignments' pointer-type='entity_position_assignment'/>

            <int32_t name='next_assignment_id'/>

            <stl-vector name='possible_evaluate' pointer-type='entity_position_assignment' since='v0.40.01'/>
            <stl-vector name='possible_succession' pointer-type='entity_position_assignment' since='v0.40.01'/>
            <stl-vector name='possible_appointable' pointer-type='entity_position_assignment' since='v0.40.01'/>
            <stl-vector name='possible_elected' pointer-type='entity_position_assignment' since='v0.40.01'/>
            <stl-vector name='possible_claimable' pointer-type='entity_position_assignment' since='v0.40.01'/>
        </compound>

        <compound name='tissue_styles'> not a compound
            <stl-vector name='all' pointer-type='entity_tissue_style'/>
            <int32_t name='next_style_id'/>
        </compound>

        <stl-vector name='squads' type-name='int32_t' ref-target='squad'/>

        <int32_t name='global_event_knowledge_year' init-value='-1'/>
        <stl-vector name='local_known_events' comment='since the above year' type-name='int32_t' ref-target='history_event'/>
        <int32_t name='production_zone_id' comment='not sure what this refers to'/>
        <!-- <compound name='law'> --> bay12: entity_lawst
        <bitfield name='conquered_site_group_flags' since='v0.34.01'> bay12: ENTITY_LAW_FLAG_*
            <flag-bit name='harsh' comment='will TORTURE_FOR_INFORMATION'/>
            <flag-bit name='hostile_occupation'/>
        </bitfield>
        <!-- </compound> -->
        <static-array name='worldgen_can_make_guildhall' count='15' index-enum='town_labor_type' type-name='int32_t' since='v0.34.01' comment='specialization_hours'/>

        <pointer name='training_knowledge' since='v0.34.06'> bay12: entity_animal_training_knowledgest
            <stl-vector name="level" index-refers-to='(find-instance $creature_raw $)'>
                <enum base-type='int32_t' type-name='training_knowledge_level'/>
            </stl-vector>
            <stl-vector name="skill_points" type-name='int32_t' index-refers-to='(find-instance $creature_raw $)'/>
        </pointer>

        -- bay12: rumor_infost
        <stl-vector name='events' pointer-type='entity_event'/>

        <int32_t name='last_checked_army_strength' since='v0.40.01'/>
        <int32_t name='pwg_ai_throttle_refugee_check' since='v0.40.01'/>
        <int32_t name='pwg_ai_throttle_create_or_reclaim_site' since='v0.40.01'/>
        <int32_t name='pwg_ai_throttle_attempt_create_site' since='v0.40.01'/>
        <int32_t name='pwg_ai_throttle_invasion_planning' since='v0.40.01'/>

        <stl-vector name='performed_poetic_forms' type-name='int32_t' ref-target='poetic_form' since='v0.42.01'/>
        <stl-vector name='performed_musical_forms' type-name='int32_t' ref-target='musical_form' since='v0.42.01'/>
        <stl-vector name='performed_dance_forms' type-name='int32_t' ref-target='dance_form' since='v0.42.01'/>
        <stl-vector name='performed_scale_id' type-name='int32_t' since='v0.42.01'/>
        <stl-vector name='performed_rhythm_id' type-name='int32_t' since='v0.42.01'/>
        -- wcid == written content ID
        <stl-vector name='well_known_wcid' type-name='int32_t' since='v0.42.01'/>

        -- bay12: entity_calendarst *calendar
        <pointer name='occasion_info' type-name='entity_occasion_info' comment="only seen on Civilization, SiteGovernment, and Religion, but not all"/>

        <stl-vector name='artifact_claims' pointer-type='artifact_claim' since='v0.44.01' comment='sorted on artifact id'/>

        <stl-vector name='honors' pointer-type='honors_type' since='v0.47.01' comment='Only merc companies. Matches #Honors groups in Legends Viewer'/>
        <int32_t name='next_honors_index' since='v0.47.01'/>

        <int32_t name='equipment_purchases' since='v0.47.01' comment="average equipment quality"/>
        <int32_t name='attack' since='v0.47.01' comment="hired battle victory"/>
        <int32_t name='total_battles' since='v0.47.01' comment="hired battle total"/>

        <pointer name='evidence_repository' since='v0.47.01' type-name='evidence_repositoryst'/>

        <stl-vector name='divination_sets' type-name='int32_t' since='v0.47.01'/>

        -- bay12: material_source_enid
        <int32_t name='founding_site_government' ref-target='historical_entity' since='v0.47.01'/>

        <stl-vector name='meeting_events' pointer-type='meeting_event'/>

        -- bay12: reportst *lastreport
        <pointer name='activity_stats' type-name='entity_activity_statistics'/>
        <int16_t name='last_report_season'/>
        <int32_t name='last_report_year'/>

        <int32_t name='imports_from'/>
        <int32_t name='offerings_from'/>
        <int32_t name='offerings_recent' comment='since the last migrant wave or diplomat visit'/>
        <static-array name='offerings_history' count='10' type-name='int32_t' comment='rotated yearly at 15th of Timber'/>
        <int32_t name='hostility_level' comment='bay12: brazenness'/>
        <int32_t name='siege_tier'/>
        <int32_t name='dwf_attack_schedule_check_timer' since='v0.40.01'/>
        <int32_t name='last_petition_year' since='v0.47.01'/>
        <int32_t name='last_petition_season_count' since='v0.47.01'/>

        <stl-vector name='armies' pointer-type='army' since='v0.40.01'/>
        <stl-vector name='army_controllers' pointer-type='army_controller' since='v0.40.01'/>
        <stl-vector name='hist_figures' pointer-type='historical_figure'/>
        <stl-vector name='nemesis' pointer-type='nemesis_record'/>

        <compound name='derived_resources'> not a compound
            <compound name='mill_cookable' type-name='material_vec_ref'/>
            <compound name='mill_dye' type-name='material_vec_ref'/>

            <stl-vector name='armor_leather' type-name='int16_t' ref-target='itemdef_armorst'/>
            <stl-vector name='armor_chain' type-name='int16_t' ref-target='itemdef_armorst'/>
            <stl-vector name='armor_plate' type-name='int16_t' ref-target='itemdef_armorst'/>
            <stl-vector name='armor_under' type-name='int16_t' ref-target='itemdef_armorst'/>
            <stl-vector name='armor_over' type-name='int16_t' ref-target='itemdef_armorst'/>
            <stl-vector name='armor_cover' type-name='int16_t' ref-target='itemdef_armorst'/>
            <stl-vector name='pants_leather' type-name='int16_t' ref-target='itemdef_pantsst'/>
            <stl-vector name='pants_chain' type-name='int16_t' ref-target='itemdef_pantsst'/>
            <stl-vector name='pants_plate' type-name='int16_t' ref-target='itemdef_pantsst'/>
            <stl-vector name='pants_under' type-name='int16_t' ref-target='itemdef_pantsst'/>
            <stl-vector name='pants_over' type-name='int16_t' ref-target='itemdef_pantsst'/>
            <stl-vector name='pants_cover' type-name='int16_t' ref-target='itemdef_pantsst'/>
            <stl-vector name='helm_leather' type-name='int16_t' ref-target='itemdef_helmst'/>
            <stl-vector name='helm_chain' type-name='int16_t' ref-target='itemdef_helmst'/>
            <stl-vector name='helm_plate' type-name='int16_t' ref-target='itemdef_helmst'/>
            <stl-vector name='helm_under' type-name='int16_t' ref-target='itemdef_helmst'/>
            <stl-vector name='helm_over' type-name='int16_t' ref-target='itemdef_helmst'/>
            <stl-vector name='helm_cover' type-name='int16_t' ref-target='itemdef_helmst'/>
            <stl-vector name='shoes_leather' type-name='int16_t' ref-target='itemdef_shoesst'/>
            <stl-vector name='shoes_chain' type-name='int16_t' ref-target='itemdef_shoesst'/>
            <stl-vector name='shoes_plate' type-name='int16_t' ref-target='itemdef_shoesst'/>
            <stl-vector name='shoes_under' type-name='int16_t' ref-target='itemdef_shoesst'/>
            <stl-vector name='shoes_over' type-name='int16_t' ref-target='itemdef_shoesst'/>
            <stl-vector name='shoes_cover' type-name='int16_t' ref-target='itemdef_shoesst'/>
            <stl-vector name='gloves_leather' type-name='int16_t' ref-target='itemdef_glovesst'/>
            <stl-vector name='gloves_chain' type-name='int16_t' ref-target='itemdef_glovesst'/>
            <stl-vector name='gloves_plate' type-name='int16_t' ref-target='itemdef_glovesst'/>
            <stl-vector name='gloves_under' type-name='int16_t' ref-target='itemdef_glovesst'/>
            <stl-vector name='gloves_over' type-name='int16_t' ref-target='itemdef_glovesst'/>
            <stl-vector name='gloves_cover' type-name='int16_t' ref-target='itemdef_glovesst'/>
        </compound>
        <static-array name='assignments_by_type' count='43'
                      index-enum='entity_position_responsibility'>
            <stl-vector pointer-type='entity_position_assignment'/>
        </static-array>

        <compound name='claims'>
            <compound name='areas' type-name='coord2d_path'/>
            <compound name='territory' type-name='coord2d_path'/>
            <compound name='territory_frontier' type-name='coord2d_path'/>
        </compound>

        <stl-vector name='children' type-name='int32_t' ref-target='historical_entity'
                    comment='territory entities'/>

        -- bay12: army_strength_material_bonus
        <int32_t name='metal_proficiency'
            comment='best IMPACT_FRACTURE/10000 + MAX_EDGE/1000 for weapon mats plus best IMPACT_FRACTURE/10000 for armor mats'/>
        <stl-vector name='weapon_proficiencies' type-name='job_skill'/>

        <pointer name='resource_allotment' type-name='resource_allotment_data' comment="Only for SiteGovernment, but not all"/>

        <stl-vector name='local_poetic_form' since='v0.42.01' pointer-type='poetic_form'/>
        <stl-vector name='local_musical_form' since='v0.42.01' pointer-type='musical_form'/>
        <stl-vector name='local_dance_form' since='v0.42.01' pointer-type='dance_form'/>
        <stl-vector name='well_known_wc' since='v0.42.01' pointer-type='written_content'/>

        -- worldgen only, unsaved
        <int16_t name='settlement_x' init-value='-1'/>
        <int16_t name='settlement_y' comment='uninitialized'/>
        <bool name='settlement_toggled' comment='0'/>
        <pointer name='landmass' type-name='world_landmass'/>                      -- Civ entities. Nil for sites.
        <pointer name='region' type-name='world_region' has-bad-pointers='true'/>  -- Civ entities. Non pointers for sites.
        <int32_t name='world_gen_army_strength' comment='uninitialized'/>
        <int16_t name='connect_two_site_throttle_time' comment='0'/>

        <stl-vector name='construct_shortest_con_throttle_stid' type-name='int32_t' comment='used during world gen'/>
        <stl-vector name='construct_shortest_con_throttle_time' type-name='int16_t' comment='used during world gen'/>

        <int16_t name='snatcher_site_toggle_count' comment='0'/>
        <int32_t name='war_fatigue' comment='0'/>
        <int32_t name='army_reeling_attack' comment='0'/>
        <int32_t name='unkarmy_reeling_defense' comment='0'/>

        <stl-vector name='attacked_site_id' type-name='int32_t' comment='used during world gen'/>
        <stl-vector name='attacked_site_timer' type-name='int32_t' comment='used during world gen'/>

        <int32_t name='did_wg_variable_position'/>
        <int32_t name='did_wg_variable_market_position'/>
        <int32_t name='dig_caution_end_year'/>
        <int32_t name='total_pop'/>
        <int32_t name='eating_pop_carn'/>
        <int32_t name='eating_pop_omni'/>
        <int32_t name='working_pop'/>
        <int32_t name='working_e_pop'/>
        <int32_t name='layabout_pool'/>
        <int32_t name='peasant_pool'/>

        <int32_t name='peasant_labor_hours' since='v0.47.01'/>?
        <int32_t name='total_food_veg' since='v0.47.01'/>?
        <int32_t name='total_food_carn' since='v0.47.01'/>?

        <static-array name='trade_current_amount' count='38' type-name='int32_t'/>
        <static-array name='trade_needed_amount' count='38' type-name='int32_t'/>
        <static-array name='trade_wanted_amount' count='38' type-name='int32_t'/>
        <static-array name='trade_maximum_buy_price' count='38' type-name='int32_t'/>
        <static-array name='town_labor_hours' count='15' type-name='int32_t'/>

        <stl-vector name='world_gen_entity_debt'>
            <pointer> bay12: world_gen_entity_debtst
                <int32_t name='civ' ref-target='historical_entity'/>
                <int32_t name='amount'/>
                <int32_t name='age_weeks'/>
            </pointer>
        </stl-vector>
        <int32_t name='account' since='v0.47.01'/>

        <stl-vector name='burial_request' since='v0.34.01'>
            <pointer> bay12: entity_burial_requestst
                <int32_t name='civ' ref-target='historical_entity'/>
                <stl-vector name='prof' type-name='int32_t' comment='profession?'/>
                <enum name='status' base-type='int32_t'> bay12: EntityBurialRequestStatusType
                    <enum-item name='NEW'/>
                    <enum-item name='ENTOMBED'/>
                    <enum-item name='ALREADY_ENTOMBED_ELSEWHERE'/>
                    <enum-item name='CULLED'/>
                    <enum-item name='RAISED'/>
                    <enum-item name='SKIPPED'/>
                    <enum-item name='UNREACHABLE'/>
                </enum>
            </pointer>
        </stl-vector>
        <pointer name='current_wgwg' pointer-type='world_gen_wandering_groupst'/>
        <int32_t name='total_outcast_strength' since='v0.47.01'/>
        <int32_t name='temporary_count'/>
        -- protected --
        <size_t name='pool_id'/>
    </struct-type>

    <struct-type type-name='entity_tissue_style' original-name='entity_tissue_stylest' key-field='id'>
        <code-helper name='describe'>$.name</code-helper>
        <code-helper name='find-instance'>
            (find-by-id $(find-instance $historical_entity $$).tissue_styles.all $id $)
        </code-helper>

        <stl-string name='name'/>
        <stl-vector name='preferred_shapings' type-name='tissue_style_type'/>
        <stl-vector name='shaping_chance' type-name='int32_t'/>
        <int32_t name='maintain_length_min'/>
        <int32_t name='maintain_length_max'/>
        <int32_t name='id'/>
    </struct-type>

    <enum-type type-name='training_knowledge_level' base-type='int32_t'> bay12: AnimalTrainingKnowledgeType
        <enum-item name='None'/>
        <enum-item name='FewFacts'/>
        <enum-item name='GeneralFamiliarity'/>
        <enum-item name='Knowledgeable'/>
        <enum-item name='Expert'/>
        <enum-item name='Domesticated'/>
    </enum-type>

    <enum-type type-name='entity_position_flags'> bay12: EntityPositionFlagType
        <enum-item name='IS_LAW_MAKER' comment='bay12: ATTACK_IS_TREASON'/>
        <enum-item name='ELECTED'/>
        <enum-item name='DUTY_BOUND'/>
        <enum-item name='MILITARY_SCREEN_ONLY'/>
        <enum-item name='GENDER_MALE' comment='bay12: FORCED_GENDER_MALE'/>
        <enum-item name='GENDER_FEMALE' comment='bay12: FORCED_GENDER_FEMALE'/>
        <enum-item name='SUCCESSION_BY_HEIR'/>
        <enum-item name='HAS_RESPONSIBILITIES'/>

        <enum-item name='FLASHES'/>
        <enum-item name='BRAG_ON_KILL'/>
        <enum-item name='CHAT_WORTHY'/>
        <enum-item name='DO_NOT_CULL'/>
        <enum-item name='KILL_QUEST'/>
        <enum-item name='IS_LEADER' comment='bay12: ADD_CONV_SKILLS_AT_WORLD_GEN'/>
        <enum-item name='IS_DIPLOMAT' comment='bay12: DIPLOMATIC_DRAFT_AVOIDANCE'/>
        <enum-item name='EXPORTED_IN_LEGENDS'/>

        <enum-item name='DETERMINES_COIN_DESIGN'/>
        <enum-item name='ACCOUNT_EXEMPT'/>
        <enum-item name='HAS_MET_POP_REQ'/>
        <enum-item name='HAS_BEEN_REPLACED'/>
        <enum-item name='COLOR' comment='bay12: USE_COLOR'/>
        <enum-item name='RULES_FROM_LOCATION'/>
        <enum-item name='MENIAL_WORK_EXEMPTION'/>
        <enum-item name='MENIAL_WORK_EXEMPTION_SPOUSE'/>

        <enum-item name='SLEEP_PRETENSION'/>
        <enum-item name='PUNISHMENT_EXEMPTION'/>
        <enum-item name='HAS_RECEIVED_POSITIONS'/>
        <enum-item name='ACTIVE'/>
        <enum-item name='QUEST_GIVER'/>
        <enum-item name='SPECIAL_BURIAL'/>
        <enum-item name='REQUIRES_MARKET'/>
        <enum-item name='HAS_MET_MARKET_REQ'/>
    </enum-type>

    <struct-type type-name='entity_position' original-name='entity_positionst' key-field='id'>
        <stl-string name='code'/>
        <int32_t name='id'/>

        <code-helper name='describe'>$.code</code-helper>

        <df-flagarray name='flags' index-enum='entity_position_flags'/>

        <stl-vector name='allowed_creature' type-name='int32_t' ref-target='creature_raw'/>
        <stl-vector name='allowed_class' pointer-type='stl-string'/>

        <stl-vector name='rejected_creature' type-name='int32_t' ref-target='creature_raw'/>
        <stl-vector name='rejected_class' pointer-type='stl-string'/>

        <static-array type-name='stl-string' name='name' count='2'/> bay12: string[EntityPositionStringType]
        <static-array type-name='stl-string' name='name_female' count='2'/>
        <static-array type-name='stl-string' name='name_male' count='2'/>
        <static-array type-name='stl-string' name='spouse' count='2'/>
        <static-array type-name='stl-string' name='spouse_female' count='2'/>
        <static-array type-name='stl-string' name='spouse_male' count='2'/>
        <static-array type-name='stl-string' name='squad' count='2'/>
        <stl-string name='land_name'/>

        <int16_t name='squad_size'/>

        <stl-vector name='commander_id' type-name='int32_t'/>
        <stl-vector name='commander_civ' type-name='int32_t' ref-target='historical_entity'/>
        <stl-vector name='commander_types' type-name='int16_t'/>

        <int16_t name='land_holder'/>
        <int16_t name='requires_population'/>

        <enum name='execution_skill' type-name='job_skill' since='v0.34.01'/>

        <int32_t name='precedence' init-value='30001'/>
        <int32_t name='replaced_by' init-value='-1'/>
        <int16_t name='number' init-value='1'/>

        <stl-vector name='appointed_by' type-name='int32_t'/>
        <stl-vector name='appointed_by_civ' type-name='int32_t' ref-target='historical_entity'/>
        <stl-vector name='succession_by_position' type-name='int32_t'/>

        <static-array type-name='bool' name='responsibilities' count='43' index-enum='entity_position_responsibility'/>
        <stl-string name='description'/>
        <static-array type-name='int16_t' name='color' count='3'/>

        <int32_t name='required_boxes'/>
        <int32_t name='required_cabinets'/>
        <int32_t name='required_racks'/>
        <int32_t name='required_stands'/>

        <int32_t name='required_office'/> bay12: int32_t[DemandRooms]
        <int32_t name='required_bedroom'/>
        <int32_t name='required_dining'/>
        <int32_t name='required_tomb'/>

        <int32_t name='mandate_max'/>
        <int32_t name='demand_max'/>
        <int32_t name='best_appointment_precedence' init-value='30001' since='v0.47.01'/>
    </struct-type>

    <struct-type type-name='entity_position_profile_claimst' key-field='hfid'>
        <int32_t name='hfid' comment='bay12: local_id is an alias'/>
    </struct-type>

    <struct-type type-name='entity_position_assignment' key-field='id' original-name='entity_position_profilest'>
        <int32_t name='id' comment='bay12: global_id'/>

        <code-helper name='describe'>
            (describe-obj $.position_id.refers-to)
            (awhen $.histfig.ref-target
              (describe-obj it))
        </code-helper>

        <int32_t name='histfig' ref-target='historical_figure' comment='bay12: holder_hfid'/>
        <int32_t name='histfig2' ref-target='historical_figure' since='v0.40.01' comment='bay12: last_holder_hfid'/>
        <int32_t name='position_id'
                 refers-to='(find-by-id $$._global._parent._global.positions.own $id $)'
                 comment='position within relevant entity'/>
        <int32_t name='position_vector_idx' init-value='-1' comment='bay12: position_cache_index'/>

        <df-flagarray name='flags' comment='bay12: flag'/>
        <int32_t name='squad_id' ref-target='squad' comment='bay12: leads_squad_id'/>
        <int32_t name='st_id' init-value='-1'/>
        <int32_t name='ab_id' init-value='-1'/>
        <int32_t name='vassal_of_entity_id' init-value='-1' since='v0.40.01'/>
        <int32_t name='vassal_of_position_profile_id' init-value='-1' since='v0.40.01'/>
        <stl-vector name='claim' pointer-type='entity_position_profile_claimst' since='v0.40.01' comment='not saved'/>
        <int32_t name='assigned_army_controller_id' since='v0.47.01' comment='unknown size, not initialized or saved'/>
    </struct-type>

    <enum-type type-name='entity_material_category' base-type='int16_t'> bay12: EntityMaterialType
        <enum-item name='None' value='-1'/>
        <enum-item name='Clothing' comment='cloth or leather'/>
        <enum-item name='Leather' comment='organic.leather'/>
        <enum-item name='Cloth' comment='any cloth'/>
        <enum-item name='Wood' comment='organic.wood, used for training weapons'/>
        <enum-item name='Crafts' comment='misc_mat.crafts'/>
        <enum-item name='Stone' comment='stones'/>
        <enum-item name='Improvement' comment='misc_mat.crafts'/>
        <enum-item name='Vial' comment='misc_mat.vials'/>
        <enum-item name='Barrel' comment='misc_mat.barrels, also used for buckets'/>
        <enum-item name='Bag' comment='cloth/leather'/>
        <enum-item name='Cage' comment='misc_mat.cages'/>
        <enum-item name='WeaponMelee' comment='metal.weapon'/>
        <enum-item name='WeaponRanged' comment='metal.ranged'/>
        <enum-item name='Ammo' comment='metal.ammo'/>
        <enum-item name='AmmoMetal' comment='metal.ammo_metal'/>
        <enum-item name='Pick' comment='metal.pick'/>
        <enum-item name='Armor' comment='metal.armor, also used for shields, tools, instruments, and toys'/>
        <enum-item name='Gem' comment='gems'/>
        <enum-item name='Bone' comment='refuse.bone'/>
        <enum-item name='Shell' comment='refuse.shell'/>
        <enum-item name='Pearl' comment='refuse.pearl'/>
        <enum-item name='Ivory' comment='refuse.ivory'/>
        <enum-item name='Horn' comment='refuse.horn'/>
        <enum-item name='Other' comment='misc_mat.others'/>
        <enum-item name='Anvil' comment='metal.anvil'/>
        <enum-item name='Booze' comment='misc_mat.booze'/>
        <enum-item name='Chain' comment='metals with ITEMS_HARD, used for chains'/>
        <enum-item name='PlantFiber' comment='organic.fiber'/>
        <enum-item name='Silk' comment='organic.silk'/>
        <enum-item name='Wool' comment='organic.wool'/>
        <enum-item name='PermFurniture' comment='misc_mat.perm_furniture'/>
        <enum-item name='TempFurniture' comment='misc_mat.temp_furniture'/>
        <enum-item name='Tent'/>
        <enum-item name='Sheet'/>
    </enum-type>

    <struct-type type-name='entity_uniform_item' original-name='item_creation_paramst'>
        <int8_t name='random_dye'/>
        <int8_t name='armorlevel'/>
        <int16_t name='item_color' ref-target='descriptor_color'/>
        <int32_t name='art_image_id'/>
        <int16_t name='art_image_subid'/>
        <int16_t name='image_thread_color' ref-target='descriptor_color'/>
        <enum name='image_material_class' type-name='entity_material_category'/>
        <int16_t name='maker_race'/>
        <bitfield name="indiv_choice" type-name='uniform_indiv_choice'/>
        <int16_t name="mattype" ref-target='material' aux-value='$$.matindex'/>
        <int32_t name="matindex"/>
        <enum name="material_class" type-name='entity_material_category'/>
    </struct-type>

    <enum-type type-name='entity_uniform_type' base-type='int16_t'> bay12: EntityUniformType
        <enum-item name='None' value='-1'/>
        <enum-item name='Guard'/>
        <enum-item name='HighPriest'/>
        <enum-item name='Priest'/>
        <enum-item name='Soldier'/>
    </enum-type>

    <struct-type type-name='entity_uniform' original-name='entity_uniformst' key-field='id'>
        <int32_t name="id"/>
        <enum name="type" type-name='entity_uniform_type'/>

        <code-helper name='describe'>
            (describe-obj $.name)
        </code-helper>

        <static-array name='uniform_item_types' count='7' index-enum='uniform_category'>
            <stl-vector>
                <enum base-type='int16_t' type-name='item_type'/>
            </stl-vector>
        </static-array>

        <static-array name='uniform_item_subtypes' count='7' index-enum='uniform_category'>
            <stl-vector>
                <int16_t refers-to='(item-subtype-target $$._parent._parent._parent.uniform_item_types[$$._parent._key][$$._key] $)'/>
            </stl-vector>
        </static-array>

        <static-array name='uniform_item_info' count='7' index-enum='uniform_category'>
            <stl-vector pointer-type='entity_uniform_item'/>
        </static-array>

        <stl-string name="name"/>

        <bitfield name='flags' type-name='uniform_flags'/>
    </struct-type>

    <enum-type type-name='entity_event_type' base-type='int32_t'> bay12: RumorType
        <enum-item name='invasion'/>
        <enum-item name='abduction'/>
        <enum-item name='incident'/>
        <enum-item name='occupation'/>
        <enum-item name='beast'/>
        <enum-item name='group'/>
        <enum-item name='harass'/>
        <enum-item name='flee'/>
        <enum-item name='abandon'/>
        <enum-item name='reclaimed'/>
        <enum-item name='founded'/>
        <enum-item name='reclaiming'/>
        <enum-item name='founding'/>
        <enum-item name='leave'/>
        <enum-item name='insurrection'/>
        <enum-item name='insurrection_end'/>
        <enum-item name='succession'/>
        <enum-item name='claim'/>
        <enum-item name='accept_tribute_offer'/>
        <enum-item name='refuse_tribute_offer'/>
        <enum-item name='accept_tribute_demand'/>
        <enum-item name='refuse_tribute_demand'/>
        <enum-item name='accept_peace_offer'/>
        <enum-item name='refuse_peace_offer'/>
        <enum-item name='cease_tribute_offer'/>
        <enum-item name='artifact_in_site'/>
        <enum-item name='artifact_in_subregion'/>
        <enum-item name='artifact_in_feature_layer'/>
        <enum-item name='artifact_in_inventory'/>
        <enum-item name='artifact_not_in_site'/>
        <enum-item name='artifact_not_in_subregion'/>
        <enum-item name='artifact_not_in_feature_layer'/>
        <enum-item name='artifact_not_in_inventory'/>
        <enum-item name='artifact_was_destroyed'/>
    </enum-type>

    <struct-type type-name='entity_event' original-name='rumorst'>
        <compound name='data' is-union='true'>
            <compound name='invasion'> bay12: rumor_army_marching_to_sitest
                <int32_t name='entity_id' ref-target='historical_entity'/>
                <int32_t name='site_id' ref-target='world_site'/>
                <int32_t name='attack_leader_hf' ref-target='historical_figure'/>
                <int32_t name='attack_commander_hf' ref-target='historical_figure'/>
            </compound>
            <compound name='abduction'> bay12: rumor_hist_figure_abductedst
                <int32_t name='histfig_id' ref-target='historical_figure' comment='abductee'/>
                <int32_t name='site_id' ref-target='world_site'/>
                <int32_t name='abductor_id' ref-target='historical_figure'/>
                <int32_t name='event' ref-target='history_event'/>
            </compound>
            <compound name='incident'> bay12: rumor_incidentst
                <enum name='type' type-name='incident_type'/>
                <int32_t name='incident_id' ref-target='incident'/>
            </compound>
            <compound name='occupation'> bay12: rumor_occupationst
                <int32_t name='site_id' ref-target='world_site'/>
                <int32_t name='entity_id' ref-target='historical_entity'/>
                <int32_t name='leader_hf' ref-target='historical_figure'/>
                <int32_t name='evicted_entity_id' ref-target='historical_entity'/>
            </compound>
            <compound name='beast'> bay12: rumor_beast_presentst
                <int32_t name='histfig_id' ref-target='historical_figure'/>
                <int32_t name='site_id' ref-target='world_site'/>
                <int32_t name='region_id' ref-target='world_region'/>
            </compound>
            <compound name='group'> bay12: rumor_entity_site_presentst
                <int32_t name='entity_id' ref-target='historical_entity'/>
                <int32_t name='site_id' ref-target='world_site'/>
            </compound>
            <compound name='harass'> bay12: rumor_army_harassing_sitest
                <int32_t name='entity_id' ref-target='historical_entity'/>
                <int32_t name='site_id' ref-target='world_site'/>
                <int32_t name='army_leader_hf_id' ref-target='historical_figure'/>
            </compound>
            <compound name='flee'> bay12: rumor_refugees_fleeing_armyst
                <int32_t name='refugee_entity_id' ref-target='historical_entity'/>
                <int32_t name='from_site_id' ref-target='world_site'/>
                <int32_t name='army_entity_id' ref-target='historical_entity'/>
                <int32_t name='army_leader_hf_id' ref-target='historical_figure'/>
            </compound>
            <compound name='abandon'> bay12: rumor_refugees_abandon_mismanaged_sitest
                <int32_t name='entity_id' ref-target='historical_entity'/>
                <int32_t name='site_id' ref-target='world_site'/>
                <int32_t name='parent_entity_id' ref-target='historical_entity'/>
            </compound>
            <compound name='reclaimed'> bay12: rumor_site_reclaimedst
                <int32_t name='behalf_entity_id' ref-target='historical_entity'/>
                <int32_t name='site_id' ref-target='world_site'/>
                <int32_t name='reclaimer_entity_id' ref-target='historical_entity'/>
                <int32_t name='leader_hf' ref-target='historical_figure'/>
            </compound>
            <compound name='founded'> bay12: rumor_site_createdst
                <int32_t name='entity_id' ref-target='historical_entity'/>
                <int32_t name='site_id' ref-target='world_site'/>
                <int32_t name='parent_entity_id' ref-target='historical_entity'/>
                <int32_t name='leader_hf' ref-target='historical_figure'/>
            </compound>
            <compound name='reclaiming'> bay12: rumor_reclaim_army_leaving_for_sitest
                <int32_t name='entity_id' ref-target='historical_entity'/>
                <int32_t name='site_id' ref-target='world_site'/>
                <int32_t name='civ_leader_hf' ref-target='historical_figure'/>
                <int32_t name='civ_commander_hf' ref-target='historical_figure'/>
            </compound>
            <compound name='founding'> bay12: rumor_site_creation_army_leavingst
                <int32_t name='entity_id' ref-target='historical_entity'/>
                <int32_t name='region_id' ref-target='world_region'/>
                <int32_t name='civ_leader_hf' ref-target='historical_figure'/>
                <int32_t name='civ_commander_hf' ref-target='historical_figure'/>
            </compound>
            <compound name='leave'> bay12: rumor_occupation_pulling_out_of_sitest
                <int32_t name='entity_id' ref-target='historical_entity'/>
                <int32_t name='site_id' ref-target='world_site'/>
            </compound>
            <compound name='insurrection'> bay12: rumor_insurrection_startedst
                <int32_t name='site_id' ref-target='world_site'/>
                <int32_t name='entity_id' ref-target='historical_entity'/>
            </compound>
            <compound name='insurrection_end'> bay12: rumor_insurrection_endedst
                <int32_t name='site_id' ref-target='world_site'/>
                <int32_t name='entity_id' ref-target='historical_entity'/>
                <enum name='result' type-name='insurrection_outcome'/>
            </compound>
            <compound name='succession'> bay12: rumor_new_position_holderst
                <int32_t name='histfig_id' ref-target='historical_figure'/>
                <int32_t name='former_histfig_id' ref-target='historical_figure'/>
                <int32_t name='entity_id' ref-target='historical_entity'/>
                <int32_t name='position_assignment_id' refers-to='$(find-entity $$._parent.entity_id).positions.assignments[$]'/>
            </compound>
            <compound name='claim'> bay12: rumor_site_claimed_by_new_entityst
                <int32_t name='entity_id' ref-target='historical_entity'/>
                <int32_t name='site_id' ref-target='world_site'/>
                <int32_t name='histfig_id' ref-target='historical_figure'/>
            </compound>
            <compound name='accept_tribute_offer'> bay12: rumor_entity_agrees_to_accept_tributest
                <int32_t name='entity1_id' ref-target='historical_entity'/>
                <int32_t name='histfig1_id' ref-target='historical_figure'/>
                <int32_t name='entity2_id' ref-target='historical_entity'/>
                <int32_t name='histfig2_id' ref-target='historical_figure'/>
            </compound>
            <compound name='refuse_tribute_offer'> bay12: rumor_entity_refuses_to_accept_tributest
                <int32_t name='entity1_id' ref-target='historical_entity'/>
                <int32_t name='histfig1_id' ref-target='historical_figure'/>
                <int32_t name='entity2_id' ref-target='historical_entity'/>
                <int32_t name='histfig2_id' ref-target='historical_figure'/>
            </compound>
            <compound name='accept_tribute_demand'> bay12: rumor_entity_agrees_to_give_tributest
                <int32_t name='entity1_id' ref-target='historical_entity'/>
                <int32_t name='histfig1_id' ref-target='historical_figure'/>
                <int32_t name='entity2_id' ref-target='historical_entity'/>
                <int32_t name='histfig2_id' ref-target='historical_figure'/>
            </compound>
            <compound name='refuse_tribute_demand'> bay12: rumor_entity_refuses_to_give_tributest
                <int32_t name='entity1_id' ref-target='historical_entity'/>
                <int32_t name='histfig1_id' ref-target='historical_figure'/>
                <int32_t name='entity2_id' ref-target='historical_entity'/>
                <int32_t name='histfig2_id' ref-target='historical_figure'/>
            </compound>
            <compound name='accept_peace_offer'> bay12: rumor_entity_agrees_to_make_peacest
                <int32_t name='entity1_id' ref-target='historical_entity'/>
                <int32_t name='histfig1_id' ref-target='historical_figure'/>
                <int32_t name='entity2_id' ref-target='historical_entity'/>
                <int32_t name='histfig2_id' ref-target='historical_figure'/>
            </compound>
            <compound name='refuse_peace_offer'> bay12: rumor_entity_refuses_to_make_peacest
                <int32_t name='entity1_id' ref-target='historical_entity'/>
                <int32_t name='histfig1_id' ref-target='historical_figure'/>
                <int32_t name='entity2_id' ref-target='historical_entity'/>
                <int32_t name='histfig2_id' ref-target='historical_figure'/>
            </compound>
            <compound name='cease_tribute_offer'> bay12: rumor_entity_cancels_tributest
                <int32_t name='entity1_id' ref-target='historical_entity'/>
                <int32_t name='histfig1_id' ref-target='historical_figure'/>
                <int32_t name='entity2_id' ref-target='historical_entity'/>
                <int32_t name='histfig2_id' ref-target='historical_figure'/>
            </compound>
            <compound name='artifact_in_site'> bay12: rumor_artifact_present_at_sitest
                <int32_t name='artifact_id' ref-target='artifact_record'/>
                <int32_t name='site_id' ref-target='world_site'/>
                <int32_t name='structure_id' ref-target='abstract_building'/>
            </compound>
            <compound name='artifact_in_subregion'> bay12: rumor_artifact_present_at_subregionst
                <int32_t name='artifact_id' ref-target='artifact_record'/>
                <int32_t name='subregion_id' ref-target='world_region'/>
            </compound>
            <compound name='artifact_in_feature_layer'> bay12: rumor_artifact_present_at_feature_layerst
                <int32_t name='artifact_id' ref-target='artifact_record'/>
                <int32_t name='feature_layer_id' ref-target='world_underground_region'/>
            </compound>
            <compound name='artifact_in_inventory'> bay12: rumor_artifact_held_by_hfst
                <int32_t name='artifact_id' ref-target='artifact_record'/>
                <int32_t name='hist_figure_id' ref-target='historical_figure'/>
            </compound>
            <compound name='artifact_not_in_site'> bay12: rumor_artifact_not_present_at_sitest
                <int32_t name='artifact_id' ref-target='artifact_record'/>
                <int32_t name='site_id' ref-target='world_site'/>
                <int32_t name='structure_id' ref-target='abstract_building'/>
            </compound>
            <compound name='artifact_not_in_subregion'> bay12: rumor_artifact_not_present_at_subregionst
                <int32_t name='artifact_id' ref-target='artifact_record'/>
                <int32_t name='subregion_id' ref-target='world_region'/>
            </compound>
            <compound name='artifact_not_in_feature_layer'> bay12: rumor_artifact_not_present_at_feature_layerst
                <int32_t name='artifact_id' ref-target='artifact_record'/>
                <int32_t name='feature_layer_id' ref-target='world_underground_region'/>
            </compound>
            <compound name='artifact_not_in_inventory'> bay12: rumor_artifact_not_held_by_hfst
                <int32_t name='artifact_id' ref-target='artifact_record'/>
                <int32_t name='hist_figure_id' ref-target='historical_figure'/>
            </compound>
            <compound name='artifact_destroyed'> bay12: rumor_artifact_destroyedst
                <int32_t name='artifact_id' ref-target='artifact_record'/>
            </compound>
        </compound>
        <int32_t name='valid_year' comment="often the same as the other year/tick. Start/stop time?"/>
        <int32_t name='valid_year_tick'/>
        <int32_t name="year"/>
        <int32_t name="year_tick"/>
        <bitfield name='flag' base-type='uint32_t'> bay12: RUMOR_FLAG_*
            <flag-bit name='outmoded'/>
        </bitfield>
        <enum name='type' type-name='entity_event_type'/>
    </struct-type>

    <struct-type type-name='agreement' key-field='id' original-name='agreementst'
                 instance-vector='$global.world.agreements.all'>
        <int32_t name='id'/>
        <stl-vector name='parties' pointer-type='agreement_party'/>
        <int32_t name='next_party_id'/>
        <stl-vector name='details' pointer-type='agreement_details'/>
        <int32_t name='next_details_id'/>
        <int32_t name='smm_x'/>
        <int32_t name='smm_y'/>
        <bitfield name='flags' since='v0.42.01'> bay12: AGREEMENT_FLAG_*
            <flag-bit name='petition_not_accepted' comment='this gets unset by accepting a petition'/>
            <flag-bit name='convicted_accepted' comment="concluded"/>
        </bitfield>
    </struct-type>

    <struct-type type-name='agreement_party' original-name='agreement_partyst' key-field='id'>
        <int32_t name='id'/>
        <stl-vector type-name='int32_t' name='histfig_ids' ref-target='historical_figure'/>
        <stl-vector type-name='int32_t' name='entity_ids' ref-target='historical_entity'/>
        <stl-vector name='complaint'>
            <pointer> bay12: agreement_complaintst
                <enum type-name='history_event_reason' name='reason'/>
                <int32_t name='subject_id' ref-target='agreement_details'/>
                <int32_t name='year'/>
                <int32_t name='tick'/>
            </pointer>
        </stl-vector>
    </struct-type>

    <enum-type type-name='evidence_type' base-type='int32_t'> bay12: EvidenceType
        <enum-item name='NONE' value='-1'/>
        <enum-item name='PLOTTER_BRIBERY_ATTEMPT'/>
        <enum-item name='PLOTTER_SEDITION_ATTEMPT'/>
        <enum-item name='PLOTTER_SKIM_EMBEZZLEMENT_ATTEMPT'/>
        <enum-item name='PLOTTER_ASSASSINATION_ATTEMPT'/>
        <enum-item name='PLOTTER_ABDUCTION_ATTEMPT'/>
        <enum-item name='PLOTTER_SABOTAGE_ATTEMPT'/>
        <enum-item name='PLOTTER_THEFT_ATTEMPT'/>
        <enum-item name='CAUGHT_INFILTRATING'/>
        <enum-item name='SUSPECT_CONFESSED_AGREEMENT'/>
        <enum-item name='CAUGHT_UNDER_SURVEILLANCE'/>
    </enum-type>

    <enum-type type-name='intrigue_corruption_action_type' base-type='int32_t'> bay12: IntrigueCorruptionActionType
        <enum-item name='NONE' value='-1'/>
        <enum-item name='BRIBE_OFFICIAL'/>
        <enum-item name='BRING_INTO_ASSET_NETWORK'/>
        <enum-item name='CORRUPT_IN_PLACE_GENERALLY'/>
        <enum-item name='INDUCE_TO_EMBEZZLE'/>
    </enum-type>

    <enum-type type-name='agreement_details_type' base-type='int32_t'> bay12: AgreementSubjectType
        <enum-item name='JoinParty'/>
        <enum-item name='DemonicBinding'/>
        <enum-item name='Residency'/>
        <enum-item name='Citizenship'/>
        <enum-item name='Parley'/>
        <enum-item name='PositionCorruption' comment="Embezzlement and accepting bribes seen. For own gain and for 'sponsor'"/>
        <enum-item name='PlotStealArtifact'/>
        <enum-item name='PromisePosition'/>
        <enum-item name='PlotAssassination'/>
        <enum-item name='PlotAbduct'/>
        <enum-item name='PlotSabotage'/>
        <enum-item name='PlotConviction'/>
        <enum-item name='Location'/>
        <enum-item name='PlotInfiltrationCoup'/>
        <enum-item name='PlotFrameTreason'/>
        <enum-item name='PlotInduceWar'/>
    </enum-type>

    <struct-type type-name='agreement_details' original-name='agreement_subjectst' key-field='id'>
        <int32_t name='id'/>
        <int32_t name='year'/>
        <int32_t name='year_tick'/>
        <compound name='data' is-union='true'>
            <pointer name='JoinParty' type-name='agreement_details_data_join_party'/>
            <pointer name='DemonicBinding' type-name='agreement_details_data_demonic_binding'/>
            <pointer name='Residency' type-name='agreement_details_data_residency'/>
            <pointer name='Citizenship' type-name='agreement_details_data_citizenship'/>
            <pointer name='Parley' type-name='agreement_details_data_parley'/>
            <pointer name='PositionCorruption' type-name='agreement_details_data_position_corruption'/>
            <pointer name='PlotStealArtifact' type-name='agreement_details_data_plot_steal_artifact'/>
            <pointer name='PromisePosition' type-name='agreement_details_data_promise_position'/>
            <pointer name='PlotAssassination' type-name='agreement_details_data_plot_assassination'/>
            <pointer name='PlotAbduct' type-name='agreement_details_data_plot_abduct'/>
            <pointer name='PlotSabotage' type-name='agreement_details_data_plot_sabotage'/>
            <pointer name='PlotConviction' type-name='agreement_details_data_plot_conviction'/>
            <pointer name='Location' type-name='agreement_details_data_location'/>
            <pointer name='PlotInfiltrationCoup' type-name='agreement_details_data_plot_infiltration_coup'/>
            <pointer name='PlotFrameTreason' type-name='agreement_details_data_plot_frame_treason'/>
            <pointer name='PlotInduceWar' type-name='agreement_details_data_plot_induce_war'/>
        </compound>
        <enum name='type' base-type='int32_t' type-name='agreement_details_type'/>
    </struct-type>

    <struct-type type-name='agreement_details_data_join_party' original-name='agreement_subject_join_as_companionst'>
        <enum name='reason' base-type='int32_t' type-name='history_event_reason'/>
        <int32_t name='member' ref-target='agreement_party'/>
        <int32_t name='party' ref-target='agreement_party'/>
        <int32_t name='site' ref-target='world_site' comment='possibly a Year, if for entertainment'/>
        <int32_t name='entity' ref-target='historical_entity' comment='possibly a Season, or an Identity'/>
        <int32_t name='figure' ref-target='historical_figure' comment='this is a value_type when reason == sphere_alignment'/>
        <int32_t name='end_year'/>
        <int32_t name='end_season_tick'/>
    </struct-type>

    <struct-type type-name='agreement_details_data_demonic_binding' original-name='agreement_subject_attach_to_worldst'>
        <enum name='reason' base-type='int32_t' type-name='history_event_reason'/>
        <int32_t name='demon' ref-target='agreement_party'/>
        <int32_t name='summoner' ref-target='agreement_party'/>
        <int32_t name='site' ref-target='world_site'/>
        <int32_t name='artifact' ref-target='artifact_record'/>
        <enum name='sphere' type-name='sphere_type' base-type='int32_t'/>
    </struct-type>

    <struct-type type-name='agreement_details_data_residency' original-name='agreement_subject_become_residentst'>
        <enum name='reason' base-type='int32_t' type-name='history_event_reason'/>
        <int32_t name='applicant' ref-target='agreement_party'/>
        <int32_t name='government' ref-target='agreement_party'/>
        <int32_t name='site' ref-target='world_site'/>
        <int32_t name='end_year'/>
        <int32_t name='end_season_tick'/>
    </struct-type>

    <struct-type type-name='agreement_details_data_citizenship' original-name='agreement_subject_become_citizenst'>
        <int32_t name='applicant' ref-target='agreement_party'/>
        <int32_t name='government' ref-target='agreement_party'/>
        <int32_t name='site' ref-target='world_site'/>
        <int32_t name='end_year'/>
        <int32_t name='end_season_tick'/>
    </struct-type>

    <struct-type type-name='agreement_details_data_parley' original-name='agreement_subject_arrange_parleyst'>
        <enum name='reason' base-type='int32_t' type-name='history_event_reason'/>
        <int32_t name='asker' ref-target='agreement_party'/>
        <int32_t name='target' ref-target='agreement_party'/>
        <int32_t name='site' ref-target='world_site'/>
        <int32_t name='end_year'/>
        <int32_t name='end_season_tick'/>
    </struct-type>

    <struct-type type-name='agreement_details_data_position_corruption' original-name='agreement_subject_position_corruptionst'>
        <enum name='corrupt_circumstance' type-name='unit_thought_type'/>
        <int32_t name='actor_index' ref-target='agreement_party'/>
        <int32_t name='influencer_index' ref-target='agreement_party'/>
        <int32_t name='intermediary_index' ref-target='agreement_party'/>
        <int32_t name='target_id' ref-target='historical_entity'/>
        <int32_t name='position_id' comment="bay12: related_eppid; position index in the entity's Own entity_position vector"/>
    </struct-type>

    <struct-type type-name='agreement_details_data_plot_steal_artifact' original-name='agreement_subject_steal_artifactst'>
        <int32_t name='actor_index' ref-target='agreement_party'/>
        <int32_t name='influencer_index' ref-target='agreement_party'/>
        <int32_t name='intermediary_index' ref-target='agreement_party'/>
        <int32_t name='artifact_id' ref-target='artifact_record'/>
    </struct-type>

    <struct-type type-name='agreement_details_data_promise_position' original-name='agreement_subject_promise_of_positionst'>
        <int32_t name='beneficiary_index' ref-target='agreement_party'/>
        <int32_t name='actor_index' ref-target='agreement_party'/>
        <int32_t name='promisee_index' ref-target='agreement_party'/>
        <int32_t name='influencer_index' ref-target='agreement_party'/>
        <stl-vector name='intermediary_indices' type-name='int32_t' ref-target='agreement_party'/>
        <int32_t name='entity_id' ref-target='historical_entity'/>
    </struct-type>

    <struct-type type-name='agreement_details_data_plot_assassination' original-name='agreement_subject_assassinatest'>
        <int32_t name='actor_index' ref-target='agreement_party'/>
        <int32_t name='influencer_index' ref-target='agreement_party'/>
        <int32_t name='intermediary_index' ref-target='agreement_party'/>
        <int32_t name='target_id' ref-target='historical_figure'/>
    </struct-type>

    <struct-type type-name='agreement_details_data_plot_abduct' original-name='agreement_subject_abductst'>
        <int32_t name='actor_index' ref-target='agreement_party'/>
        <int32_t name='influencer_index' ref-target='agreement_party'/>
        <int32_t name='intermediary_index' ref-target='agreement_party'/>
        <int32_t name='target_id' ref-target='historical_figure'/>
    </struct-type>

    <struct-type type-name='agreement_details_data_plot_sabotage' original-name='agreement_subject_sabotagest'>
        <int32_t name='plotter_index' ref-target='agreement_party'/>
        <int32_t name='actor_index' ref-target='agreement_party'/>
        <int32_t name='intermediary_index' ref-target='agreement_party'/>
        <int32_t name='victim_id' ref-target='historical_figure'/>
        <int32_t name='victim_civ' ref-target='historical_entity'/>
        <int32_t name='victim_site' ref-target='world_site'/>
    </struct-type>

    <struct-type type-name='agreement_details_data_plot_conviction' original-name='agreement_subject_foiled_conspiracyst'>
        <stl-vector name='criminal_indices' type-name='int32_t' ref-target='agreement_party'/>
        <enum name='corruption_action' type-name='intrigue_corruption_action_type'/>
    </struct-type>

    <struct-type type-name='agreement_details_data_location' original-name='agreement_subject_build_locationst'>
        <int32_t name='applicant' ref-target='agreement_party'/>
        <int32_t name='government' ref-target='agreement_party'/>
        <int32_t name='site' ref-target='world_site'/>
        <enum name='type' base-type='int32_t' type-name='abstract_building_type'/>
        <enum name='deity_type' type-name='religious_practice_type'/>
        <compound name='deity_data' type-name='religious_practice_data'/>
        <enum name='profession' type-name='profession'/>
        <int32_t name='tier' comment='1 = temple or guildhall, 2 = temple complex or grand guildhall; matches location_tier in abstract_building_contents'/>
        <bitfield name='flags' base-type='uint32_t'> bay12: AGREEMENT_SUBJECT_BUILD_LOCATION_FLAG_*
            <flag-bit name='warned_is_ready'/>
        </bitfield>
    </struct-type>

    <struct-type type-name='agreement_details_data_plot_infiltration_coup' original-name='agreement_subject_infiltrate_societyst'>
        <int32_t name='actor_index' ref-target='agreement_party'/>
        <int32_t name='influencer_index' ref-target='agreement_party'/>
        <int32_t name='target' ref-target='historical_entity'/>
        <uint32_t name='flags'/> bay12: INTRIGUE_PLOT_INFILTRATE_SOCIETY_FLAG_* ?
    </struct-type>

    <struct-type type-name='agreement_details_data_plot_frame_treason' original-name='agreement_subject_frame_for_crimest'>
        <int32_t name='actor_index' ref-target='agreement_party'/>
        <int32_t name='influencer_index' ref-target='agreement_party'/>
        <int32_t name='victim_id' ref-target='historical_figure'/>
        <int32_t name='fool_id' ref-target='historical_figure'/>
        <enum name='crime' type-name='crime_type'/>
    </struct-type>

    <struct-type type-name='agreement_details_data_plot_induce_war' original-name='agreement_subject_start_war_with_entityst'>
        <int32_t name='actor_index' ref-target='agreement_party'/>
        <int32_t name='influencer_index' ref-target='agreement_party'/>
        <int32_t name='attacker' ref-target='historical_entity'/>
        <int32_t name='defender' ref-target='historical_entity'/>
    </struct-type>

</data-definition>

<!--
Local Variables:
indent-tabs-mode: nil
nxml-child-indent: 4
End:
-->