Cryptid Hotel — Internal Dev Doc

File Naming
Conventions

All teams · Read before pushing anything to the repo

Version 1.0

Engine Godot 4.6

Applies to Art & Dev teams

Updated March 2026

Core Rules — No Exceptions

Before naming anything

🔡

Lowercase only Godot is case-sensitive on Linux. Always lowercase, no exceptions.

🔗

Underscores only No '-', no spaces. Use '_' as the only separator everywhere.

📁

Type prefix first Always start with the asset type so files group naturally in any folder.

🚫

No vague names No "final", "new", "v2", "test", "copy". Name what it IS.

Sprites & Images

.png · transparent background

Pattern — General

type_name_variant.png — variant is optional

Pattern — Client (one PNG per character, all parts + expressions inside)

client_race_name.png — body parts & expression frames all on one sheet, Godot cuts regions

Pattern — Placeholders (all types)

type_name_placeholder.png — temporary placeholder, will be replaced

type — client, room, item, ui, bg

name — asset name

variant — optional sub-type (icon, layer1…)

placeholder — suffix for all temporary placeholders

Filename	Type	Description
client_fresno_nightcrawler_placeholder.png	Client	Fresno Nightcrawler — placeholder
room_bedroom_placeholder.png	Room	Bedroom room — placeholder
item_candle_placeholder.png	Item	Candle item — placeholder
client_wendigo.png	Client	Wendigo — all body parts + expression frames on one sheet
Other assets
item_candle.png	Item	Candle item
bg_forest_layer1.png	BG	Forest background — parallax layer 1
ui_button_confirm.png	UI	Confirm button UI element
ui_icon_aura_noise.png	UI	Noise aura indicator icon

ℹ️Client sheets contain everything — body parts for the skeleton AND expression frames for the face. Godot defines regions from a single texture. One file per character, no splits.
⚠️If a second version coexists with the first for a real reason, use _v2 suffix. If v2 replaces v1, simply overwrite — Git keeps the history.

Audio

.ogg for music · .wav for sfx

Pattern — SFX

sfx_category_description.wav

Pattern — Music

music_zone_mood.ogg

Filename	Type	Description
sfx_client_satisfied.wav	SFX	Client satisfaction sound
sfx_client_unsatisfied.wav	SFX	Client unsatisfied sound
sfx_room_place.wav	SFX	Room placement sound
sfx_ui_click.wav	SFX	UI click
music_zone1_ambient.ogg	Music	Zone 1 ambient loop
music_boss_zone1.ogg	Music	Boss fight music — zone 1
music_hub_ambient.ogg	Music	Hub ambient loop

Scenes & Scripts

.tscn · .gd · must match each other

Pattern — Scene

descriptive_name.tscn

Pattern — Script

same_as_scene.gd — script must always match its scene name

Scene	Script	Description
fresno_nightcrawler.tscn	fresno_nightcrawler.gd	Fresno Nightcrawler client
room_base.tscn	room_base.gd	Base room scene
ui_hud.tscn	ui_hud.gd	HUD scene
game_manager.tscn	game_manager.gd	Global game manager
aura_system.tscn	aura_system.gd	Aura propagation system
day_cycle_manager.tscn	day_cycle_manager.gd	Day cycle manager

Folder Structure

res:// root · Godot project

📁 assets/

│ 📁 sprites/

│ │ 📁 clients/// all client PNGs

│ │ 📁 rooms/// all room PNGs

│ │ 📁 items/// all item PNGs

│ │ 📁 ui/// buttons, panels, icons, aura indicators

│ │ 📁 backgrounds/// bg parallax layers

│ │ 📁 others/// Other PNGs comme la base de l'hotel

│ 📁 audio/

│ │ 📁 music/// .ogg files

│ │ 📁 sfx/// .wav files

│ 📁 fonts/// .ttf / .otf

📁 scenes/

│ 📁 clients/

│ 📁 rooms/

│ 📁 ui/

│ 📁 managers/

📁 scripts/

│ 📁 clients/

│ 📁 rooms/

│ 📁 ui/

│ 📁 managers/

│ 📁 systems/// aura, day cycle, satisfaction

Common Mistakes

Fresno Nightcrawler.png → client_fresno_nightcrawler.png

room-bedroom-final.PNG → room_bedroom_placeholder.png

sound effect click v3.wav → sfx_ui_click.wav

BG_Forest_Layer1_FINAL.png → bg_forest_layer1.png

NewScript2.gd → aura_system.gd

clientFresnoNightcrawler.tscn → fresno_nightcrawler.tscn