Info
This Hunger Games Simulator exists because we were displeased with the other simulators out there; the one that we were using prior to the creation of this one (the one at brantsteele.net) made it very difficult to upload images and was utilising a needlessly convoluted server-driven system.
This simulator was created to address both of those shortcomings. With it, you can easily upload whatever images you want. You can also just give it a URL that points to a publicly accessible image, and it will work just fine—so long as your browser supports it, that is.
What's more, this simulator runs entirely in the browser, meaning that you could even download the page and use it offline if you so desired. This also means that it should be faster than the simulator we were using before, since it does not need to send data to a server and back every single time you press a button.
The events are mainly taken from the brantsteele.net simulator, though some members of our community have contributed to the event list as well. You can disable existing events or add custom events by clicking the ‘Settings’ button below and then ‘Edit Events’. You can also add new events, download all events, and upload your own.
Source Code, Bug Reports, Contributing, etc.
If you'd like to report a bug or suggest a feature, you can do so on the Agma Schwa Discord Server. Just ping Ætérnal in the #hunger-games-simulator channel.
Alternatively, you can also file an issue here. This requires you to have a free GitHub account.
The source code of nguh.org, including the Hunger Games Simulator, is hosted in this GitHub repository.
Support the game developer, Ætérnal, on Patreon.
Thanks also to GitHub user @spaulmark for implementing the bulk-upload feature.
24 January 2025
- Fixed a CSS bug that caused tribute images to not be cropped properly sometimes.
- Added settings to control when greyscale portraits are used.
- Settings (but not events) now persist across page reloads.
21 January 2025
- Characters now persist across page reloads (they are stored locally in your browser).
- All of nguh.org is now on Svelte 5.
- Refactored the Hunger Games Simulator to actually leverage Svelte.
- The ‘OK’ button of file dialogs is now disabled when no file is selected.
- The ‘Clear’ and ‘Download’ buttons in the event list are now disabled when the list is empty.
- Improved centering and alignment of the add character button.
- Moved event message syntax into a separate dialog.
- Added a setting to set the starting day/night of the game.
28 October 2024
- Added a format specifier,
%w
, for ‘was/were’.
25 September 2024
- Added a format specifier,
%e
, for verbs that have ‘-es’ in the 3rd person singular, e.g. ‘bash/bashes’, ‘catch/catches’. - Updated the description to reflect the fact that you can now add events directly from the events dialog without having to download and upload a JSON file.
18 April 2024
- The entirety of nguh.org, including this simulator, is now open source on GitHub.
09 April 2024
- Events involving fatalities are no longer grouped at the top when a fixed number or percentage of deaths per round is set. Instead, the events are now shuffled and distributed more evenly.
22 February 2024
- Added a
%h
format specifier for ‘has/have’.
26 July 2023
- Updated the page layout to be more similar to the rest of the website.
- The source code available on the HGS repository may no longer up to date as it has been reintegrated into the rest of the page. We’re exploring separating it again in case people are interested it and will be posting an update here in the changelog as soon as that happens.
12 May 2023
- Fixed a bug that made it impossible to re-enable disabled events in the events dialog.
- This was also causing some weirdness when loading event lists with mostly disabled events, which should be fixed now.
28 February 2023
- Linguistics-related events that might not be that easy to make sense of unless you’re familiar with linguistics are now disabled by default. You can still enable them in the settings if you want to.
- Consequently, any events with the
BIG LANG
type will now be disabled when loaded. Most people’s configs and custom events should not be affected by this as that event type isn’t really supposed to be used for non-builtin events anyway. - Fixed a bug that would cause players to only be awarded 1 kill per event, even if an event has multiple fatalities.
22 February 2023
- The Settings dialog now contains more settings. The events dialog can now be opened from the Settings dialog.
- Added an option to the settings dialog to set a maximum number of players that may die each round. This setting is disabled by default.
- Tributes and event text should now be centred properly in game.
- When displaying events that involve a lot of tributes, the tributes now wrap properly and are centred and spaced properly.
29 January 2023
- Due to popular request, the ‘Save Characters’ button now saves uploaded images as well!
- As a result, the downloaded config files will now be a lot larger if you’ve uploaded many large files; we’re looking into scaling down the images on save, but that may take a while to implement.
- Old config files still work; it’s just that those files didn’t save uploaded images properly, so if you have an old config file, any uploaded images in those config files will still be broken.
- If you have any old config files, we recommend updating them by uploading them (‘Load Characters’) and downloading them again (‘Save Characters’). However, old config files will still continue to work regardless and we plan to continue supporting them indefinitely.
6 July 2022
- Previously, the simulator would display an exception + stacktrace when trying to upload a non-JSON file in a context where JSON was expected. The simulator now displays an error message that explains that the file is not valid JSON instead.
- As you can see, the changelog has been moved to this dialog because it was getting too long.
- Dialogs now appear properly centred when opened.
- The simulator should now function correctly should you try and start a game with no events whatsoever. Of course, it will never get anywhere, but at least it won't crash horribly.
3 July 2022
- The old dialog API has been replaced with a newer one.
- Dialogs now use the HTML5
<dialog>
element. - Dialogs are now draggable and scrollable.
- Dialogs now stack properly.
- The input box of single file dialogs now becomes locked after selecting a file from the file manager, signifying that a file has been chosen and uploaded.
- Error dialogs that display exceptions now contain stack traces as well as instructions as to how to report a bug.
2 July 2022
- The ‘Save Characters’/‘Load Characters’ buttons no longer save/load events, only characters. This also fixes a bug that would cause people to be unable to start a game after loading characters.
26 June 2022
- The source code for the simulator has been moved to a separate GitLab repository that is now accessible to the public (see the ‘Source Code, ...’ section above).
- Several buttons have been renamed: ‘Edit Events’ is now ‘Settings’; ‘Save Setup’ and ‘Load Setup’ are now ‘Save Characters’ and ‘Load Characters’.
- The format for the config file that can be downloaded by clicking on Settings > Download has changed. You can still upload your old config files; however, when you download it again afterwards, the format will have changed.
- The event message formatter has been updated to give more helpful error messages if the message format is invalid.
13 June 2022
- The ‘Add’ and ‘Load’ buttons in the events dialog have been renamed to ‘Upload and Add’ and ‘Upload and Replace’, respectively.
- We've added a UI that should make adding events easier. You can access it by clicking on the new ‘Add’ button in the events dialog.
- The names of all stages should now be capitalised properly.
Choose your characters
Current Players: 0