https://github.com/quackster/minerva
Imager for Habbo Hotel versions in Shockwave and Flash written in C# .NET 8. Also supports badge imaging.
https://github.com/quackster/minerva
Last synced: 11 months ago
JSON representation
Imager for Habbo Hotel versions in Shockwave and Flash written in C# .NET 8. Also supports badge imaging.
- Host: GitHub
- URL: https://github.com/quackster/minerva
- Owner: Quackster
- Created: 2023-01-09T11:54:51.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2025-09-02T03:44:08.000Z (11 months ago)
- Last Synced: 2025-09-02T05:35:30.165Z (11 months ago)
- Language: C#
- Homepage:
- Size: 10.1 MB
- Stars: 17
- Watchers: 4
- Forks: 12
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Minerva
## Table of Contents
1. [Overview](#overview)
2. [Download](#download)
3. [Setup](#setup)
- [Prerequisites](#prerequisites)
- [Initial Setup](#initial-setup)
- [Group Badges In-Client Setup](#group-badges-in-client-setup)
4. [API Endpoints](#api-endpoints)
- [Habbo Figure Conversion API](#habbo-figure-conversion-api)
5. [Customization](#customization)
- [Adding Custom Clothes](#adding-custom-clothes)
6. [Integration](#integration)
- [Using with Other Languages](#using-with-other-languages)
7. [Development](#development)
- [Cloning the Repository](#cloning-the-repository)
---
## Overview
Imager for Habbo Hotel releases Shockwave and Flash. It uses the two projects (Badger, and Avatara) as libraries combined into one, to make the web server.
It supports rendering both figures/avatars and group badges, and now supports pre-v18 figure codes to render.
When used, the following endpoints will be available:
- `/habbo-imaging/avatarimage`
- `/habbo-imaging/badge/{badge-code}.gif` (This is for the client **only** due to the way Shockwave handles transparency)
- `/habbo-imaging/badge-fill/{badge-code}.gif`
## Download
The latest builds for Linux and Windows are found on the [latest](https://github.com/Quackster/Minerva/releases/tag/latest) tag.
| OS | Download |
|---|---|
| Linux (64-bit) | [Minerva-linux-x64.zip](https://github.com/Quackster/Minerva/releases/download/latest/Minerva-linux-x64.zip) |
| Windows (64-bit) | [Minerva-win-x64.zip](https://github.com/Quackster/Minerva/releases/download/latest/Minerva-win-x64.zip) |
This project is using both [Avatara](https://github.com/Quackster/Avatara) and [Badger](https://github.com/Quackster/Badger) as dependencies.
## Setup
### Prerequisites
To run Minerva, you need to install .NET 8 [runtime](https://dotnet.microsoft.com/en-us/download/dotnet/8.0) for your operating system.
### Initial Setup
Once downloaded, you may execute `./Minerva` (Linux) or `Minerva.exe` (Windows).
As soon as it starts, it will extract all the SWFS in `/figuredata/` and build the XML and image files, all this will be located in `/xml/` and `/images/` inside `/figuredata/`.
Once that's done, you should see the following console output:
```
Loading flash assets...
9762 flash assets loaded
Loading figure data...
301 figure sets loaded
11 figure set types loaded
3 figure palettes loaded
info: Microsoft.Hosting.Lifetime[14]
Now listening on: http://localhost:5000
info: Microsoft.Hosting.Lifetime[14]
Now listening on: https://localhost:5001
info: Microsoft.Hosting.Lifetime[0]
Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
Hosting environment: Production
info: Microsoft.Hosting.Lifetime[0]
Content root path...
```
The following path should give the expected output:
```
http://localhost:5000/habbo-imaging/avatarimage?figure=hd-180-1.hr-100-61.ch-210-66.lg-270-82.sh-290-80&size=b&direction=4&head_direction=4&crr=0&gesture=sml&frame=1
```
By default the port it listens on will be 5000 but this can be changed to 8080 (or any other port for your liking) with the command line arguments `--urls=http://*:8080/`
### Group Badges In-Client Setup
Minerva has a special path to use for the Shockwave client, ensure that "badge-fill" is being used.
In `external_texts.txt` (yes, the client reads from this file...)
Make sure the line is (with port 5000 being changed to what you are using):
```
group_logo_url_template=http://localhost:5000/habbo-imaging/badge-fill/%imagerdata%.gif
```
**Note:** if you are using Havana with the latest version (at minimum, released 14th January 2023), then set as line below:
```
group_logo_url_template=http://localhost/habbo-imaging/badge-fill/%imagerdata%.gif
```
Group badges should now work in-game.
## API Endpoints
### Habbo Figure Conversion API
Convert old Habbo figure codes to the new format.
**Endpoint:** `GET /habbo-imaging/avatarimage/convert?figure=YOUR_OLD_FIGURE_CODE`
**Example:**
**Request:**
```
GET /habbo-imaging/avatarimage/convert?figure=1000118001270012900121001
```
**Response:**
```json
{
"figure": "hr-100-1150.hd-180-1026.ch-210-1284.lg-270-1223.sh-290-1247.ha-0-1150"
}
```
## Customization
### Adding Custom Clothes
1. Adding more clothes is easy, ensure `/xml/` and `/images/` are either empty or don't exist in `/figuredata/`
2. Put the SWFs that have these clothes inside `/figuredata/compiled/`
3. Update `figuredata.xml` with the one that has the new clothes inside of it
Run Minerva and it should be supported.
## Integration
### Using with Other Languages
You can proxy it.
**Example in PHP:**
```php
```
**Example with Nginx:**
```nginx
location /imaging/ {
proxy_pass http://127.0.0.1:8090;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
```
## Development
### Cloning the Repository
```bash
$ git clone --recursive https://github.com/Quackster/Minerva
```
**or**
```bash
$ git clone https://github.com/Quackster/Minerva
$ git submodule update --init --recursive
```