Skip to content

SubnauticaNitrox/NitroxWebsite

Repository files navigation

Nitrox Website

The official website for the open-source, multiplayer Subnautica modification.

Discord Translation status License: GPL v3

About

The website is written with the following frameworks

API Documentation

The website provides a REST API for accessing Nitrox version information, changelogs, and blog posts.

Base URL

https://nitrox.rux.gg/api

Endpoints

Version Information

  • GET /version/latest - Get the latest version information
  • GET /version/releases - Get all available versions
  • GET /version/{version} - Get specific version information

Response Example:

{
  "url": "https://github.com/SubnauticaNitrox/Nitrox/releases/download/1.7.1.0/Nitrox_1.7.1.0.zip",
  "version": "1.7.1.0",
  "filesize": "8.2",
  "md5": "f7d25be0395feec244bc865acfa07043"
}

Changelog Information

  • GET /changelog/latest - Get the latest changelog
  • GET /changelog/releases - Get all changelogs
  • GET /changelog/{version} - Get specific version changelog

Response Example:

{
  "version": "1.7.1.0",
  "released": "2023-01-03T23:48:00Z",
  "permalink": "https://nitrox.rux.gg/pages/changelog#nitrox%C2%A01-7-1-0",
  "patchnotes": [
    "Minor fix and Adjustement for the Subnautica 2.0 incompatibility",
    "Fixed a bug where Windows 7 users would not be able to open the launcher."
  ]
}

Blog Information

  • GET /blog/latest - Get the latest blog post from the Nitrox Dev Blog

Features:

  • Automatic updates: The latest blog post is fetched from the WordPress API
  • Caching: Blog posts are cached for 1 hour

Cache Management:

# Clear the blog cache
php artisan blog:clear-cache

Translations

To make the website more accessible we have added a translation feature. If you would like to contribute by translating the Nitrox website into another language, please add your translations to the Weblate project.

Installing

  • Clone the project
  • Copy the .env.example to .env with cp .env.example .env and configure the parameters
  • Run composer install
  • and then run php artisan key:generate

Local development

To view the website you can either run

  • php artisan serve

Or if you have a webserver such as Laravel Valet you can visit the page according to your Valet configuration.

Requirements

Encountered a bug?

Please open a new issue with a detailed description of the bug you encountered and provide the url, browser and steps to reproduce the issue. If you have a screenshot that is also helpful.

Need help?

If you need any help please contact the Nitrox team using the following method:

Supported by

License

The project is open-sourced software licensed under the GNU General Public License v3.0.

Releases

No releases published

Packages

No packages published

Contributors 57