.gitignore

# LuminariMUD .gitignore
# Based on C/C++ gitignore from https://github.com/github/gitignore/blob/master/
# Maintained by Zusuk

####################
# Build Artifacts
####################

# Prerequisites and dependencies
*.d
depend
*/depend

# Object files
*.o
*.ko
*.obj
*.elf
*.lo
*.slo

# Exception: Keep minimal world .obj files (needed for deployment)
!lib/world/minimal/*.obj

# Ignore local Faerun world data
lib/world-fr/
frmaps/
# Precompiled Headers
*.gch
*.pch

# Libraries
*.lib
*.a
*.la
*.lai

# Shared objects (inc. Windows DLLs)
*.dll
*.so
*.so.*
*.dylib

# Executables
*.exe
*.out
*.app
*.i*86
*.x86_64
*.hex

# Linker output
*.ilk
*.map
*.exp

# Debug files
*.dSYM/
*.su
*.idb
*.pdb

# Kernel Module Compile Results
*.mod*
*.cmd
.tmp_versions/
modules.order
Module.symvers
Mkfile.old
dkms.conf

# Fortran module files
*.mod
*.smod

####################
# MUD Executables
####################
# Ignore everything in bin directory
bin/*
# But keep the directory itself
!bin/.gitkeep
/build_identity.h

# Also ignore utility executables if they're built in util/
util/asciipasswd
util/autowiz
util/plrtoascii
util/rebuildAsciiIndex
util/rebuildMailIndex
util/shopconv
util/sign
util/split
util/wld2html

####################
# IDE and Editor Files
####################
.vscode/
.idea/
.cursor/
.editorconfig
*.swp
*.swo
*~
*.code-workspace

####################
# AI Assistant Files
####################
# AI development guide and configuration
.claude/
.cursorrules
.cursorignore
WORK.md
.mcp.json

####################
# Backup Files
####################
*.bak
*.old
*.backup
bak/

####################
# Build Directories
####################
# Ignore everything in build directory
build/*
# But keep the directory structure
!build/.gitkeep
!build/CMakeFiles/
build/CMakeFiles/*
!build/CMakeFiles/.gitkeep

####################
# Configure-Generated Files
####################
# These are generated by running ./configure
Makefile
util/Makefile
src/conf.h
config.status
config.cache
config.log

# Autoconf/automake generated files
autom4te.cache/
cnf/autom4te.cache/
cnf/configure
cnf/conf.h.in
configure
conf.h.in
.deps/
*.Po
*.Tpo
Makefile.in
aclocal.m4
missing
install-sh
depcomp
compile
.dirstamp
stamp-h1
# Temporary configure directories
confor*/

####################
# MUD Configuration Files
####################
# These contain sensitive or environment-specific settings
campaign.h
mysql_config
vnums.h
mud_options.h
i3_config

# Database credentials (PHP tools)
docs/TODO/objectdb/mysql.php

####################
# Environment Files
####################
.env
.env.local
.env.production
.env.staging

####################
# Log Files
####################
*.log
log/*
!log/.gitkeep
syslog
syslog.*
syslog.CRASH

####################
# Debug Files
####################
gdb.txt
log/gdb.txt
.gdbcommands
.gdbcommands.*
.gdbinit_mud
.gdbinit_mud.*
core
core.*
vgcore.*

####################
# PHP Tools
####################
# Cache and temporary directories
cache/
logs/
tmp/
temp/
backups/

# Composer (if added later)
vendor/
composer.lock

####################
# MUD Runtime Data
####################

# Player files
lib/plrfiles/**/*.plr
lib/plrfiles/index
lib/plrobjs/**/*.objs

# House files
lib/house/*.house

# Runtime configuration and state files
lib/etc/badsites
lib/etc/board.*
lib/etc/clans
lib/etc/clan_investments
lib/etc/claims
lib/etc/config
lib/etc/crafts
lib/etc/hcontrol
lib/etc/last
lib/etc/plrmail
lib/etc/time

# Autorun control files (should never be committed)
.killscript
.fastboot
pause
.websocket_policy.pid
.flash_policy.pid
.autorun.lock
.autorun.state
.autorun.state.tmp.*
.autorun.lock.pid
.autorun.lock.pid.tmp.*
.mud.pid
.mud.pid.tmp.*
.mud.identity
.mud.identity.tmp.*
.watchdog.pid
.watchdog.pid.tmp.*
.killwatchdog

# Copyover/hotboot files (should never be committed)
lib/copyover.dat

# User-generated content
lib/misc/bugs
lib/misc/ideas
lib/misc/messages
lib/misc/socials
lib/misc/socials.new
lib/misc/typos
lib/misc/xnames

# Mail system
lib/mudmail/*/
lib/mudmail/index

# Quest files
lib/world/hlq/*.hlq

####################
# World Files (OLC)
####################
# These are edited in-game via OLC and should not be in version control
lib/world/mob/*.mob
lib/world/obj/*.obj
lib/world/wld/*.wld
lib/world/zon/*.zon

# artifact system runtime ownership state (generated, like player files)
lib/world/world.artifact
lib/world/world.artifact.tmp
lib/world/shp/*.shp
lib/world/trg/*.trg
lib/world/qst/*.qst

# World index files (generated)
lib/world/*/index
lib/world/*/index.mini
lib/world/*/index.backup

# Generated RoL reconciliation runs contain ignored world-data evidence.
lib/rol-conversion/

# EXCEPTION: Keep minimal world files (required for deployment)
!lib/world/minimal/
!lib/world/minimal/*

# EXCEPTION: Keep the artifact deployment package (required for deployment).
# This directory is the tracked source that scripts/provision_artifacts.sh
# reads.  It is never written by OLC; OLC edits the provisioned copies under
# lib/world/obj, lib/world/zon, lib/world/wld, and lib/world/mob instead.
!lib/world/artifacts/
!lib/world/artifacts/*

####################
# Text Files (In-Game Edited)
####################
# These are edited via tedit command in-game
lib/text/credits
lib/text/news
lib/text/motd
lib/text/imotd
lib/text/greetings
lib/text/info
lib/text/background
lib/text/handbook
lib/text/policies
lib/text/wizlist
lib/text/immlist
lib/text/oldnews

# Help files (legacy - now stored in MySQL via hedit)
lib/text/help/*
!lib/text/help/README
!lib/text/help/.gitkeep

####################
# Unit Tests
####################
/unittests/obj
/unittests/CuTest/AllTests.c
/cutest

####################
# Keep Directory Structure
####################
# Preserve empty directories with .gitkeep files
!lib/plrfiles/.gitkeep
!lib/plrfiles/*/.gitkeep
!lib/plrfiles/*/00
!lib/plrobjs/.gitkeep
!lib/plrobjs/*/.gitkeep
!lib/plrobjs/*/00
!lib/etc/.gitkeep
!lib/house/.gitkeep
!lib/misc/.gitkeep
!lib/mudmail/.gitkeep
!lib/world/hlq/.gitkeep
!lib/world/mob/.gitkeep
!lib/world/obj/.gitkeep
!lib/world/wld/.gitkeep
!lib/world/zon/.gitkeep
!lib/world/shp/.gitkeep
!lib/world/trg/.gitkeep
!lib/world/qst/.gitkeep
circle

# Ignore tar and gz files in root
/*.tar
/*.gz
/*.tar.gz

# Ignore MySQL backup files in root
/mysql*.sql

####################
# Aider AI Assistant
####################
# Aider virtual environment
aider-env/

# Aider-generated files (history, chat logs, etc.)
.aider*
.aider.input.history
.aider.chat.history.md
.aider.llm.history
.aider.conf.yml  # Only if you want to keep API keys local

# Python virtual environments in general
*-env/
venv/
.venv/

# Backup files
*.backup.*

# Compiled test binaries
/.ci-runtime*/
unittests/CuTest/autopilot_tests
unittests/CuTest/autopilot_pathfinding_tests
unittests/CuTest/npc_pilot_tests
unittests/CuTest/schedule_tests
unittests/CuTest/test_waypoint_cache
unittests/CuTest/vessel_tests
unittests/CuTest/vessel_stress_test
unittests/CuTest/protocol_parser_tests
unittests/CuTest/protocol_parser_fuzz
ascii_map.txt
FRMUD-HEX-Aunauroch.jpg
plan.md
scripts/world/populate_zone7000_from_aunauroch.py
**/__pycache__/
*.py[cod]

# Root-level working changelog (docs/CHANGELOG.md stays tracked)
/changelog
/changelog.bak

####################
# Upstream Reference Comparisons
####################
/EXAMPLE/