Lyrositor
Joined: 08 Aug 2010
Posts: 689
Location: Relto, Sea of Mist
Ever wanted to tweak manually a marker game? Transfer one between shards? Translate a particularly tricky one? Or even customize someone else's game to your liking? Rejoice, for the Marker Editor is here!
What is the Marker Editor?
The Marker Editor is a customized version of the Plasma client (Internal version) which allows you to retreive your created marker games for your avatar, download it as a JSON-formatted file (JSON is a human-readable data transfer standard), edit it to your heart's content, then re-upload it, either as a new game entirely or as a modified version of the previous one. Games are stored in a "Games" folder in your Uru installation.
How do I use it?
There are three in-game commands:
All your games must be stored in your "Games" folder, and must respect the appropriate syntax.
How do marker files work?
Each marker game is stored as a simple TXT file using JSON syntax. Here is an example file:
Let's look at each parameter:
For now, you have to edit these manually. Eventually, I might write a graphical tool to edit them for you.
Where do I obtain the Marker Editor?
The sources for the Marker Editor can be found on Github.
If you just want to run it, download this compressed file and follow these instructions:
1. Extract the compressed file somewhere on your computer.
2. Copy the dat and sfx folders from your Uru Live installation into the extracted folder.
3. Start the MarkerEditor.exe program.
I hope you enjoy it!
Disclaimer: the Marker Editor is at its first edition. There might be bugs, potentially dangerous ones. Downloading will never cause problems with your avatar; beware of uploading, however. I recommend you use testing avatars to upload new Marker Games or modified ones... for now.
What is the Marker Editor?
The Marker Editor is a customized version of the Plasma client (Internal version) which allows you to retreive your created marker games for your avatar, download it as a JSON-formatted file (JSON is a human-readable data transfer standard), edit it to your heart's content, then re-upload it, either as a new game entirely or as a modified version of the previous one. Games are stored in a "Games" folder in your Uru installation.
How do I use it?
There are three in-game commands:
- /list: generates a "list.txt" of games you currently own and their associated ID. You need this ID to download them.
- /download [id]: download your game in your "Games" folder; specify your game's ID (as found in "list.txt").
- /upload [filename]: uploads a modified game or a new game from the specified file in your "Games" folder.
All your games must be stored in your "Games" folder, and must respect the appropriate syntax.
How do marker files work?
Each marker game is stored as a simple TXT file using JSON syntax. Here is an example file:
Code:
{
"guid": "519af903-7982-4382-95c4-7b68ad48a942",
"name": "A Marker Game",
"markers": [
{
"text": "First marker",
"age": "Personal",
"coords": [
22.330049514770508,
-31.966373443603516,
6.036035060882568
]
},
{
"text": "Second marker",
"age": "Personal",
"coords": [
47.967952728271484,
-49.584068298339844,
3.017317295074463
]
}
],
"creator": "Avatar"
}Let's look at each parameter:
- guid: a unique identifier for your game. If you are editing an existing game, you need to have it included. Omit it if you are creating a new game. Never modify it.
- name: the marker game's name; not required if editing an existing game.
- markers: an array of dictionaries. Each dictionary contains information about a marker: "text" is the name of the marker, "age" the filename of the Age in which it is located, and coords, which is a list of XYZ coordinates for the marker (relative to the center of the Age).
- creator: the name of the marker game's creator. Not used by the Marker Editor; for management purposes.
For now, you have to edit these manually. Eventually, I might write a graphical tool to edit them for you.
Where do I obtain the Marker Editor?
The sources for the Marker Editor can be found on Github.
If you just want to run it, download this compressed file and follow these instructions:
1. Extract the compressed file somewhere on your computer.
2. Copy the dat and sfx folders from your Uru Live installation into the extracted folder.
3. Start the MarkerEditor.exe program.
I hope you enjoy it!
Disclaimer: the Marker Editor is at its first edition. There might be bugs, potentially dangerous ones. Downloading will never cause problems with your avatar; beware of uploading, however. I recommend you use testing avatars to upload new Marker Games or modified ones... for now.
_________________
Lyrositor
Explorer #16601888
Unless otherwise stated, opinions are mine only and not Guild endorsed.



