Saltar al contenido principal

BTC Give Reward

Adds a reward to a player's pending queue (with optional cron scheduling)

Campos

CampoTipoPredeterminadoDescripción
artifactRef<RewardsArtifactEntry>—Artifact for reward storage
rewardRef<RewardDefinitionEntry>—Reward definition to give
customDataString{}Custom data to attach to this reward instance (JSON format)
useCronBooleanfalseEnable cron-based scheduling (e.g., daily, weekly rewards)
cronExpressionCronExpression—Cron expression for scheduled rewards (e.g., '0 0 0 * * *' for daily at midnight). Only used if useCron is true.
Campos comunes de TypeWriter (criteria, modifiers, triggers)
CampoTipoPredeterminadoDescripción
criteriaList<Criteria>empty—
modifiersList<Modifier>empty—
triggersList<Ref<TriggerableEntry>>empty—

How to use it​

Link artifact and reward; without them nothing is queued. customData is stored with the queued record and handed to the Reward Claimed event as REWARD_CUSTOM_DATA.

With useCron on, the action remembers when it last granted for each player (per action entry). It grants again only once the next time matching cronExpression has passed, so 0 0 0 * * * gives at most one reward per day. Each action entry has its own memory: duplicate the action for another schedule.