HytaleModding Wiki

This is the official Wiki project from HytaleModding, hosted at https://wiki.hytalemodding.dev. It allows mod teams to create and manage documentation for their mods, making it easy for players and developers to find the information they need.

Requirements

Before you start, make sure you have the following installed:

• PHP 8.2 or newer
• Composer
• Node.js 18 or newer
• Bun
• Git

You also need these PHP extensions enabled:

• fileinfo
• iconv
• pdo_sqlite
• sqlite3

You can check the PHP extensions required by the lockfile with:

composer check-platform-reqs

Getting Started

Clone the repository and install the project dependencies:

git clone https://github.com/HytaleModding/wiki.git
cd wiki
composer install
bun install

Create your local environment file and application key:

cp .env.example .env
php artisan key:generate

Create the local SQLite database, run migrations, seed demo data, and link storage:

touch database/database.sqlite
php artisan migrate --seed
php artisan storage:link

Start the local development server:

composer dev

The app will be available at http://localhost:8000.

Demo Accounts

After seeding the database, you can log in with:

Email	Password
admin@example.com	password
user@example.com	password
collaborator@example.com	password

Development Commands

Run the frontend development server only:

bun run dev

Build frontend assets:

bun run build

Run frontend formatting, linting, and type checks:

bun run quality

Run PHP tests and style checks:

composer test

Format PHP code with Laravel Pint:

./vendor/bin/pint

Resetting Local Data

To rebuild your local database from scratch and seed it again:

php artisan migrate:fresh --seed

Troubleshooting

If composer install fails with a message like requires ext-iconv, your PHP CLI installation is missing a required extension. Composer can detect and report missing extensions, but extensions are installed through your operating system, package manager, PHP version manager, or Docker image.

Run this to see which php.ini file your terminal PHP is using:

php --ini

Run this to list enabled PHP extensions:

php -m

For the most reproducible local setup, use a PHP environment manager or Docker image that includes the required extensions instead of installing extensions one by one on each machine.

Contributing

If you'd like to contribute to this project, you can follow our Contributing Guide.