Technical

Technical information for Elasto Mania files, available APIs and various development stuff.

Elasto Mania

Note: All Elasto Mania files are in little-endian format.

The type name will depend on what programming language you are working with, here's a short equivalency list between the most common ones as a reference:

Bytes	C	Python¹	Rust
1	char	c	u8/i8²
1	uchar	B	u8
2	short	h	i16
4	int	i	i32
4	uint	I	u32
4	float	f	f32
8	double	d	f64

¹ Using struct formatting [1]
² Depends on context. Assume that all chars in Elma files are ASCII and never expected to be signed, use u8. Probably?

Levels

8)

Language Examples

C/C++

wow test

Python

There is already a nice Elma Python library by sigvef that should cover most of your needs. If not, there's some nice code examples for how you can unpack/pack files if you look at the source code.

Rust

wow test

APIs

Currently there are two online APIs available for public use.

Elma Online API 2.0

Official API for the Elma Online site. Use this API if you want to get best times for a certain level.

Battle API

Domovoy and b0ne's API that gives you current battle information in either XML or JSON format, and also calls to start levels.

Get battle information

URLs are http://elma.seamy.ru:8880/current_battle for XML, http://elma.seamy.ru:8880/current_battle?json=1 for JSON
There's currently no direct way to get level information like the map and non-battle times. You'll unfortunately need to fetch the battle URL by the ID field and parse the HTML data to get the level ID from there. Then either use the official EOL API to get best times, or construct the map URL from the level ID.

Map URL examples:
http://elmaonline.net/images/map/346023/ No parameters gives you a 330px max X-resolution picture.
http://elmaonline.net/images/map/346023/1800/ To get 1810px max X-resolution picture. X-resolution adds 10px.
http://elmaonline.net/images/map/346023/0/1800/ To get 1832px max Y-resolution picture. Y-resolution adds 32px.
If you add both restraints it will only use the highest axis for scaling and ignore the other axis' restraint.
The lowest resolution it will scale the axes to is 287 (297px actual) for the X-axis, and 287 (297px actual) for the Y-axis.
Maximum resolution seems completely arbitrary and changes from level to level somehow. Some levels you can have in the 7000-7200px range, others stop at 5000 or so. Further information would be useful.

Field	Context
designer	EOL Name of player. Example URL: http://elmaonline.net/players/DIvAn
file_name	Level file name. As there can be multiple levels with the same name, use the id field instead if you want to fetch the level information.
start_delta	Seconds elapsed from battle start. Given in negative values, so just add it to duration field to get time left.
battle_type	Battle type: 0: Normal 1: One life 2: First finish 3: Slowness 4: Survivor 5: Last result 6: Finish count 7: 1 Hour TT 8: Flag tag 9: Apple 10: Speed
battle_attrs	Bitmask for battle attributes: 1: See others 2: See times 4: Allow starter 8: Apple bug 16: No volt 32: No turn 64: One turn 128: No brake 256: No throttle 512: Always throttle 1024: Drunk 2048: No significance, ignore. No explanation, ask mila 4096: One-wheel 8192: Multiplayer
duration	Total battle time in seconds. Use start_delta field to get remaining time.
id	Battle ID. Example URL: http://elmaonline.net/battles/104896

http://elma.seamy.ru:8880/current_battle XML example result:
 
 <CurrentBattle>
   <designer>DIvAn</designer>
   <file_name>D339.lev</file_name>
   <start_delta>-175</start_delta>
   <battle_type>0</battle_type>
   <battle_attrs>2050</battle_attrs>
   <duration>420</duration>
   <id>104896</id>
 </CurrentBattle>
 

http://elma.seamy.ru:8880/current_battle?json=1 JSON example result:

 { 
   "designer":"DIvAn",
   "file_name":"D339.lev",
   "start_delta":-187,
   "battle_type":0,
   "battle_attrs":2050,
   "duration":420,
   "id":104896
 }
 

Start levels

Put stuff here.