Item Blacklist

Based on game build 718694 | Last updated: 2026-04-04

Overview

item_blacklist.lua is an autogenerated data configuration file used by the account items and inventory systems. It does not contain component logic or entity behaviors. Instead, it defines four global tables that map prefab names to boolean flags or event identifiers. These tables control whether specific items appear in displays, whether skin decorations are hidden, which events lock certain skins, and which skins are marked as unlockable. Modders should treat this file as read-only configuration data.

Usage example

-- Check if an item is blacklisted from display
if ITEM_DISPLAY_BLACKLIST["bernie_cat_active"] then
    print("This item is hidden from display.")
end

-- Check event lock for a skin
local event = SKINS_EVENTLOCK["hermithouse_yule"]
if event then
    print("This skin is locked behind event: " .. event)
end

Dependencies & tags

Components used: None identified Tags: data, config, skins, inventory

Properties

Property	Type	Default Value	Description
ITEM_DISPLAY_BLACKLIST	table	—	Maps prefab names to true. Items listed here are excluded from certain UI displays or inventory views.
HIDE_SKIN_DECORATIONS	table	—	Maps prefab names to true. Items listed here have their skin decorations hidden in relevant contexts.
SKINS_EVENTLOCK	table	—	Maps prefab names to event strings (e.g., "winters_feast"). Indicates which seasonal event is required to unlock the skin.
UNLOCKABLE_SKINS	table	—	Maps prefab names to true. Marks specific skins as available for unlocking through gameplay or achievements.

Main functions

None identified.

Events & listeners

None.