You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Adam Johnson 8ca4af9a78 Merge pull request #430 from zrax/plFormat_stuff 11 years ago
Docs Move Plasma20 to be the new repository root 14 years ago
Sources Merge pull request #430 from zrax/plFormat_stuff 11 years ago
cmake ASSume that MSVC is the only compiler who uses the __declspec() syntax 11 years ago
.gitattributes Keep binary identity with whitespace fixes, and don't break the zip 14 years ago
.gitignore Add a Doxyfile and some plString documentation 12 years ago
CMakeLists.txt Put compiler checks in their own cmake module 11 years ago
COPYING.txt Open source re-licensing 13 years ago
CREDITS.txt Open source re-licensing 13 years ago
Doxyfile Add better documentation, and fix some floating point flag stuff 11 years ago
LICENSE.txt Fix line endings and tabs 14 years ago
README.md Added line to readme about Qt5 dependency 11 years ago
example_server.ini Make UruLauncher use curl as well 14 years ago
prepare_env.bat Update README and add prepare_env scripts. 11 years ago
prepare_env.ps1 Update README and add prepare_env scripts. 11 years ago

README.md

Plasma

A CMake-based fork of the GPLv3-licensed CyanWorlds.com Engine (Headspin/Plasma), with a focus on bug-fixes, cross-platform compatibility, and enhanced features.

For more information on Myst Online, see http://mystonline.com/developers/

For a project roadmap, see https://github.com/H-uru/Plasma/wiki/Roadmap

  • moul-scripts - An updated repository of game scripts containing bug-fixes and compatible with modern python interpreters for use with Plasma.
  • dirtsand - An open-source Plasma-compatible server project.

Library Dependencies

Plasma currently requires the following third-party libraries:

The following libraries are optional:

Reducing the use of proprietary libraries is a focus of development and should be expected to change.

PhysX and DirectX SDK will need to be acquired through the above links. All other required libraries are available as precompiled binaries and associated files in the development libraries bundle or can be built using their individual build instructions.

Compiling Instructions

Currently, compilation only targets Windows systems and requires Visual Studio 2013 (including Visual Studio 2013 Express for Windows Desktop).

Quick-start instructions:

  1. Run the prepare_env.bat script included in the repository.
  2. You should now have a build folder with a Visual Studio solution file (.sln) inside.
  3. Open the solution in Visual Studio. You can compile CyanWorlds.com Engine by pressing Build -> Build Solution. This will take some time.

To configure manually with CMake and build:

  1. Start CMake-GUI.
  2. Set the Where is the source code option to the location where you cloned the repository.
  3. Set the Where to build the binaries option to a subfolder of the aforementioned location called build.
  4. Check the Grouped and Advanced options.
  5. Press Configure. Select Visual Studio 12 as the generator.
  6. Set the CMAKE_INSTALL_PREFIX option under CMAKE to the cwe-prefix folder that you extracted from the development libraries bundle.
  7. Press Configure again.
  8. Press Generate. You will now have a Visual Studio solution file (.sln) in the folder that you specified to build the binaries in.
  9. Open the solution in Visual Studio. You can compile CyanWorlds.com Engine by pressing Build -> Build Solution. This will take some time.

Running Instructions

To run the Internal Client for testing with MOULa content, you will need the a fully-patched installation of MOULa provided by Cyan Worlds. In addition, you will need to download or clone the files available on the moul-scripts repository.

  1. Copy the files from your existing MOULa installation to a new folder, or install fresh if you do not already have it installed. This folder will be referred to as MOUL-OS for the remainder of these instructions.
  2. Copy the Python and SDL folders from moul-scripts into the MOUL-OS folder, as well as the files in dat into the existing dat folder.
  3. Copy the example_server.ini file from the root of the Plasma repository into your MOUL-OS folder, and rename it as server.ini. If you are running your own dirtsand server or are connecting to one run by someone else, use the server.ini generated from that.
  4. Copy the DLLs from the development libraries bundle, as well as the DLLs PhysXLoader.dll, NxExtensions.dll, NxCooking.dll, and NxCharacter.dll from your PhysX SDK installation into the MOUL-OS folder.
  5. Copy the resource.dat file from <build_dir>\bin to the MOUL-OS folder, or from http://www.guildofwriters.org/tools/resource.dat if you did not build your own.
  6. Create a shortcut in the MOUL-OS folder to the compiled plClient.exe.
  7. Edit the shortcut's properties, and after the final quotation mark in the Target field, add /LocalData. Also, change the Start in field to the path of your MOUL-OS folder.
  8. Double-click the shortcut to connect to your server and test!

Alternatively, if you wish to be able to debug using a single content folder from inside Visual Studio, you will need to do the following for each Configuration (Debug, Release, etc.) you have:

  1. Open the Plasma Solution in Visual Studio.
  2. Right-click on the plClient project in the Solution Explorer.
  3. Select Configuration Properties->Debugging.
  4. Enter /LocalData in the Command Arguments field.
  5. Enter your MOUL-OS folder path in the Working Directory field.

Additional Information

About Non-Free Libraries

This software uses some non-free libraries for which exceptions appear in the source code license inserts. It is suggested that anyone who thinks of doing substantial further work on this program should first free it from dependence on the non-free libraries so that it does the same job without the non-free libraries. Further introduction of non-free libraries likely would require a revised license and thus permission from all contributors to the codebase. That being problematic, any additional non-free libraries are unlikely to be accepted by Cyan Worlds or the development community.

Acknowledgements

OPENSSL

This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/). This product includes cryptographic software written by Eric A. Young (eay@cryptsoft.com). This product includes software written by Tim J. Hudson (tjh@cryptsoft.com).

Independent JPEG Group (IJG) JPEG Library

This software is based in part on the work of the Independent JPEG Group.