Plasma Tools Documentation

Announcements and discussion regarding any projects related to Cyan Worlds' Plasma Engine including (but not limited to) CyanWorlds.com Engine, Drizzle, OfflineKI, PyPRP, and libHSPlasma.

Plasma Tools Documentation

Postby J'Kla » Mon Jul 16, 2018 7:01 am

I have found and installed Setup-PS30-Beta.exe

This installs the tools

Plasma Shop
Prp Shop
Vault Shop

Does anyone know where I can find the documentation for these (assuming there is any).

I am prepared to study but I can only do that if there is some documentation. ;)
User avatar
J'Kla
 
Posts: 882
Joined: Wed Feb 20, 2008 3:16 pm
Location: Geordieland UK

Re: Plasma Tools Documentation

Postby Sirius » Mon Jul 16, 2018 9:43 am

I don't think there is a documentation for the tools themselves, as they are pretty straightforward most of the time. It's mostly open/edit/save/close.

However the files they open usually have a complex structure and aren't really documented. The good thing is that you can also use them on Cyan files to learn.

Here are the files each tool opens:

PlasmaShop:
  • .age files (encrypted text file)
    lists which PRPs are in the Age, along with a few information like sequence prefix and max number of player.
  • .fni files (encrypted text file)
    list of console commands to execute when linking to the Age. This is used most notably to set fog color and density.
  • .sum files
    simple list of "checksums". Checksums are used by the engine to determine if someone modified/hacked a PRP file. In other words: each checksum is a single number which sums up the content of the PRP. If you modify a single bit in a PRP, the checksum is completely different and the game refuses to load the Age.
    It's an encryption thingy. All you need to know is that if you intend to do PRP hacking you should update the corresponding checksum after each modif, OR remove the checksum entry entirely.
  • .sdl files (encrypted text file)
    I think you are already a bit familiar with those ;) some of the basics have already been explained in another topic.
  • .pak files (python packages)
    Stores compiled Python scripts. You can extract and decompile Python scripts, then repack them.
  • .cfg, .dat, and a few others
    PlasmaShop can open a few of those. Not all, but it's good to keep it in mind.

PrpShop:
  • .age files
    This simply loads all the PRPs associated with the .age file. To view the actual content of the .age file, use PlasmaShop.
  • .prp files
    This is where PRP hackers like me have all their fun :P PRPs are binary files containing the Age's models, textures, logic, etc, and are generated by Korman or 3dsMax. PlasmaShop allows you to edit each object in a PRP using either an interface (when available), or an XML representation of the object. Remember: you can right-click each object in the left-hand view to bring more options.
    I recommend trying Chacal's city modifications (on Uru CC only) to get the hang of the tool.
    Remember that PRPs are extremely complex files, containing thousand of objects of hundred of different types, which were never documented (usually people just figure out on their own how they work, or ask on this forum for informations about those). It will probably be daunting at first depending on what you intend to do, but this is what allow you for instance to add new clothing items like you've been asking for recently (not for the faint of heart, once more...).
    You'll probably notice some objects, like Python File Mods correspond to Korman NodeTree objects (but more complex).
    (I also recommend to check Tools → show typeids to sort objects by order of importance)

VaultShop:
this allows you to alter savegames. I don't know much about it, though, as I never used it.



So yeah, once more you'll probably have to find your own way by learning with the tools themselves and the files we got from Cyan. :roll:
User avatar
Sirius
 
Posts: 1055
Joined: Mon Jul 26, 2010 4:46 am
Location: France

Re: Plasma Tools Documentation

Postby J'Kla » Tue Jul 17, 2018 1:12 am

Thanks Sirius as I was even lacking this stuff.

Chacal's city modifications I dare say this will provide significant pointers. :-)
User avatar
J'Kla
 
Posts: 882
Joined: Wed Feb 20, 2008 3:16 pm
Location: Geordieland UK

Re: Plasma Tools Documentation

Postby Chacal » Tue Jul 17, 2018 7:52 am

Note: Prpshop is the prp editor. When you open a prp file is Plasmashop, it opens in PrpShop.
Also most PrpShop functions can be scripted with the prpmod utility. I wrote an entire mod distribution system with it, which I never published.
I'm still around if you need help.
Chacal


"The weak can never forgive. Forgiveness is an attribute of the strong."
-- Mahatma Gandhi
User avatar
Chacal
 
Posts: 2413
Joined: Tue Nov 06, 2007 2:45 pm
Location: Quebec, Canada

Re: Plasma Tools Documentation

Postby J'Kla » Wed Jul 18, 2018 1:00 am

Hi Chacal.

I have been digging around in the prp stuff lately and I draw your attention to the discussion in the thread where I am requesting help with a T-Shirt Mod

viewtopic.php?f=10&t=6931.

There appears to be some confusion on PRPShop versions as to what you can and can't do and this may be related to the fact that I am trying to mod a dirtsand instalation LocalData.

By default dirtsand is a MOULa export and I am working with ages I am building using Korman so my ages are not at issue here.

But I am trying to modify clothing items for use in a LAN dirtsand shard (Note not online public access).

I am aware that Sirius noted your Mods were for the CC version of the city.

Are you aware of any restrictions re clothing mods on MOULa Global Clothing?
User avatar
J'Kla
 
Posts: 882
Joined: Wed Feb 20, 2008 3:16 pm
Location: Geordieland UK

Re: Plasma Tools Documentation

Postby Chacal » Wed Jul 18, 2018 6:51 am

Sorry, I never tried to mod clothing, so I wouldn't know.
Chacal


"The weak can never forgive. Forgiveness is an attribute of the strong."
-- Mahatma Gandhi
User avatar
Chacal
 
Posts: 2413
Joined: Tue Nov 06, 2007 2:45 pm
Location: Quebec, Canada


Return to Plasma Development

Who is online

Users browsing this forum: No registered users and 1 guest

cron