create-resource

Create Resource

Generate a custom Resource class so designers (or a future you) can author data as .tres files in the editor instead of hardcoded Dictionary literals.

Why Resources over Dictionaries

Concern	Dictionary	Custom Resource
Type safety	none (Variant)	typed @export fields
Editor authoring	code only	Inspector with field hints
Validation	runtime checks	@export_range, @export_enum, etc.
Refactor rename	grep	rename in script, all .tres re-resolve
Save/load	fragile	first-class, ResourceSaver.save
Diff in git	unstructured	clean key=value text

Use Dictionary only for transient runtime payloads (state machine state, signal arguments, network packets).

Template — basic Resource

class_name {Name}
extends Resource

@export var id: StringName
@export var display_name: String
# add fields here

Save to scripts/resources/{snake_case}.gd. Then in the FileSystem dock right-click → New Resource → {Name} to author .tres instances under resources/{plural}/.

Common templates

Item

class_name Item
extends Resource

@export var id: StringName
@export var display_name: String
@export_multiline var description: String
@export var icon: Texture2D
@export var max_stack: int = 1
@export var value: int = 0
@export_enum("Common", "Uncommon", "Rare", "Epic", "Legendary") var rarity: int = 0
@export var tags: Array[StringName] = []
@export var on_use: Script  ## script that defines a static use(actor: Node) -> void

Ability / Spell

class_name Ability
extends Resource

@export var id: StringName
@export var display_name: String
@export_multiline var description: String
@export var icon: Texture2D
@export var cooldown: float = 1.0
@export var resource_cost: int = 0   ## mana / energy / stamina
@export_range(0.0, 50.0, 0.5) var range: float = 5.0
@export var damage: int = 0
@export var effect_scene: PackedScene
@export var sound: AudioStream
@export var animation_name: StringName = &""
@export var tags: Array[StringName] = []   ## "fire", "ranged", "channeled"