WorldData: Economy Config

Part of WorldData. This page covers economy configuration: tax rates, trade broker parameters, dropped item behavior with per-item exceptions, death penalties with level-based condition penalties, revival settings, and movement/physics configuration.

Tax

Section: economyConfig.tax Operations: update

Store and skill tax rates.

Property	Type	Since	Description
`storeTax`	`decimal`	v92	Tax rate applied to store purchases
`skillTax`	`decimal`	v92	Tax rate applied to skill learning

economyConfig:
  tax:
    storeTax: 0.05
    skillTax: 0.1

TradeBroker

Section: economyConfig.tradeBroker Operations: update

Auction house / trade broker parameters.

Property	Type	Since	Description
`expireDays`	`int`	v92	Listing expiration in days
`transactionFeeRate`	`decimal`	v92	Transaction fee percentage
`historyLimitDays`	`int`	v92	Transaction history retention days
`tCatBuyItNowFeeRate`	`decimal`	v92	T-Cat buy-it-now fee rate
`eliteUnionMemberDiscountRateOfRegisterFeeRate`	`decimal`	v92	Elite guild member listing fee discount
`otherUnionMemberRipOffRateOfRegisterFeeRate`	`int`	v92	Non-guild member listing fee surcharge
`minAvgPriceCalcTime`	`int`	v92	Minimum time window for average price calculation
`minAvgPriceCalcMaxDays`	`int`	v92	Maximum days for average price calculation

economyConfig:
  tradeBroker:
    expireDays: 14
    transactionFeeRate: 0.05
    historyLimitDays: 30

DroppedItem

Section: economyConfig.droppedItem Operations: update (flat properties), create/update/delete (exceptions)

Dropped item behavior: looting distance, ownership timers, and per-item exception overrides.

Flat properties

Property	Type	Since	Description
`lootingDistance`	`int`	v92	Maximum distance to pick up items
`distributionDistance`	`int`	v92	Distance for group loot distribution
`ownershipGuaranteeSec`	`int`	v92	Seconds of ownership protection
`spawnGuaranteeSec`	`int`	v92	Seconds before item despawns
`ownershipGuaranteeSecForLootingBoundItem`	`int`	v92	Ownership protection for bound items
`spawnGuaranteeSecForLootingBoundItem`	`int`	v92	Despawn timer for bound items
`classPriority`	`decimal`	v92	Class priority weight for loot distribution
`divideSec`	`int`	v92	Time window for loot division
`addDivideSec`	`int`	v92	Additional division time per item
`enchantDropRadicalRoot`	`int`	v92	Enchant drop probability radical root

Exception entries (CRUD)

Per-item overrides for spawn guarantee timers.

Property	Type	Since	Description
`itemId`	`int`	v92	Item template ID (key)
`spawnGuaranteeSec`	`int`	v92	Custom despawn timer for this item

Examples

economyConfig:
  droppedItem:
    lootingDistance: 200
    ownershipGuaranteeSec: 30
    exceptions:
      create:
        - itemId: 8001
          spawnGuaranteeSec: 120
      delete:
        - itemId: 8002

Death

Section: economyConfig.death Operations: update (flat properties), create/update/delete (conditionPenalty)

Death penalties: item destruction rate, condition decrease, and level-based condition penalty entries.

Flat properties

Property	Type	Since	Description
`delRateCustomizeItem`	`decimal`	v92	Destruction rate for customized items on death
`dimConditionValue`	`int`	v92	Condition value decrease on death

ConditionPenalty entries (CRUD)

Level-range-based condition penalty applied on death.

Property	Type	Since	Description
`pcLevelOver`	`int`	v92	Minimum player level (composite key)
`pcLevelUnder`	`int`	v92	Maximum player level (composite key)
`conditionPenalty`	`int`	v92	Condition penalty amount

Examples

economyConfig:
  death:
    delRateCustomizeItem: 0.1
    dimConditionValue: 5
    conditionPenalty:
      create:
        - pcLevelOver: 11
          pcLevelUnder: 65
          conditionPenalty: 100
      update:
        - pcLevelOver: 1
          pcLevelUnder: 10
          changes:
            conditionPenalty: 50
      delete:
        - pcLevelOver: 66
          pcLevelUnder: 70

Revival

Section: economyConfig.revival Operations: update

Auto-revival and recovery settings.

Property	Type	Since	Description
`autoRevivalTime`	`int`	v92	Seconds before auto-revival prompt
`recoveryRateHp`	`decimal`	v92	HP recovery percentage on revival
`abnormalityId`	`int`	v92	Abnormality applied on revival

economyConfig:
  revival:
    autoRevivalTime: 30
    recoveryRateHp: 0.1
    abnormalityId: 44830001

MoveConfig

Section: economyConfig.moveConfig Operations: update

Movement and physics parameters including jumping, falling, climbing, swimming, and defense movement.

Property	Type	Since	Description
`userSpeedMax`	`int`	v92	Maximum player movement speed
`airFriction`	`decimal`	v92	Air friction coefficient
`fallingStartHeight`	`int`	v92	Height at which falling state begins
`fallingAngle`	`int`	v92	Angle threshold for falling detection
`fallingSpeed`	`int`	v92	Terminal falling speed
`fallingDamageHeight`	`int`	v92	Height at which fall damage begins
`fallingLandingMotionHeight`	`int`	v92	Height threshold for landing animation
`jumpHeight`	`int`	v92	Maximum jump height
`jumpDuration`	`int`	v92	Jump animation duration (ms)
`jumpFallingStartHeight`	`int`	v92	Height for falling state after jump apex
`climbingSpeed`	`int`	v92	Climbing movement speed
`climbingRange`	`int`	v92	Maximum climbable height
`damageUnitHeight`	`int`	v92	Height units for fall damage calculation
`hpDecreaseRatePerUnit`	`decimal`	v92	HP loss percentage per damage height unit
`swimmingAbnormalityId`	`int`	v92	Abnormality applied while swimming
`swimmingAbnormalityIdForPopori`	`int`	v92	Swimming abnormality for Popori race
`jumpReactionRate`	`decimal`	v92	Reaction rate multiplier while jumping
`jumpReactionType`	`int`	v92	Reaction type during jump
`movingDefenceForwardSpeed`	`int`	v92	Movement speed while blocking forward
`movingDefenceMaxRotationAngle`	`int`	v92	Max rotation angle while blocking

economyConfig:
  moveConfig:
    userSpeedMax: 500
    jumpHeight: 200
    jumpDuration: 600
    fallingDamageHeight: 800
    hpDecreaseRatePerUnit: 0.1