Lyrositor Post subject: The Marker Editor Post Posted: Sat Aug 11, 2012 8:16 pm
What is the Marker Editor?The Marker Editor is a set of Python scripts for the H'uru client which allow you to retrieve your created marker games for your avatar, download it as a YAML-formatted file (YAML 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.
How do marker files work?Each marker game is stored as a simple TXT file using YAML syntax.
creator: Avatar
guid: 519af903-7982-4382-95c4-7b68ad48a942
markers:
- age: Personal
coords: [22.330049514770508, -31.966373443603516, 6.036036014556885]
text: First marker
- age: Personal
coords: [24.330049514770508, -30.966373443603516, 6.036036014556885]
text: Second marker
name: A Marker Game
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 Marker Editor files can be downloaded as a ZIP file here:
http://lyros.net/files/MarkerEditor_Python.zipIf you want to run it, download an H'uru client and install it (you can find a pre-built one here; be sure to follow all the installation and running options) and follow these instructions:
1. Extract the Marker Editor files to a location on your computer.
2. Delete or rename the "Python" file in your H'uru client installation.
3. Copy the Marker Editor's "Python" folder to your H'uru client installation. You should have four folders in this folder now: "dat", "Python", "SDL" and "sfx".
4. Run the H'uru client with the "/SkipPreload" argument. You can now use the Marker Editor's commands in-game!
I hope you enjoy it!
Disclaimer: the Marker Editor is at its first edition. There might still 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.
NOTED: SOME MAY HAVE A LATER VERSION.Annabelle Wrote:
For the client now:
It's rather simple of use. You have to know 3 commands.
/list
/upload
/download
To download quests from the game to your PC:
1) Type "/list" on your KI
There will be a list in txt format created in a folder called "Games"
EVERY quests located in your Ages' folders will be listed there.
NONE of the quests located in your incoming folder will be listed though.
2) Search for a specific quest, there will be a number attached to the quest.
0: A quest made by Jahmen
1: Another quest made by Jahmen
2: A third one
Etc.
3) Go back to MOULa and type "/download 0"
The game will be in txt format and located in your Games folder
That's it!
To upload a quest from your PC to the game:
1) You must put the quest in the folder called "Games".
For your info, I store my quests in sub-folders inside the folder "Games" but when it's time for me to upload them back on the server, I make a copy in "Games" to be able to upload them.
Important step here
2) You must remove the GUID (will be the 2nd line of your txt file)
Even if you are the author of the quest, you won't be able to upload it back without removing the GUID. So with that said, every new upload will create a whole new quest, a new copy to be exact.
Optional step
3) You can if you want rename the txt file of the game you want to reload.
The game will be called Jahmen0.txt, for you that's not much of an issue but for me with let's say Skydiver Annabelle, I have her quests named SkydiverAnnabelle0.txt, etc.
Call it let's say Q1.txt (for Quest 1)
4) Go back to MOULa, type "/upload [name of the file].txt"
The quest will be saved with under the current age's folder with its in-game name.
That's it!
I hope you have enough information now

_________________
Annabelle 47907 - New avatar