OU
/
CWE-ou-minkata
mirror of https://foundry.openuru.org/gitblit/r/CWE-ou-minkata.git
2
1
Fork 0
Code Releases Activity
Browse Source

Merge pull request #333 from Mystler/readme 

README update.

- Update Guild of Writers address.
- Enhance formatting in step-by-step instructions.
- Various other updates and typographical fixes.
Joseph Davies 11 years ago
parent
c74dd5d42e 6dfb8ccc4c
commit
dc1e676d75
1 changed files with 35 additions and 32 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Split View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 67
      README.rst

67
README.rst
Unescape View File

@ -16,7 +16,7 @@ Library Dependencies
--------------------
Plasma currently utilizes the following third-party libraries:
- nVidia PhysX 2.6.4 - http://developer.nvidia.com/physx-downloads
- nVidia PhysX 2.6.4 - http://www.nvidia.com/object/physx_archives.html#SDK
- Creative Labs' OpenAL SDK 1.1 - http://connect.creativelabs.com/openal/Downloads/OpenAL11CoreSDK.zip
- Microsoft DirectX SDK
- November 2008 - http://www.microsoft.com/downloads/en/details.aspx?FamilyID=5493f76a-6d37-478d-ba17-28b1cca4865a or
@ -32,67 +32,70 @@ Plasma currently utilizes the following third-party libraries:
- speex - http://www.speex.org/downloads/
- zlib - http://zlib.net/
- PCRE - http://www.pcre.org/
- libcurl - http://curl.haxx.se/
- PyGTK - http://www.pygtk.org/downloads.html
- PIL - http://www.pythonware.com/products/pil/
- (optional, for plFontConverter) Freetype - http://freetype.org/
Reducing the use of proprietary libraries is a focus of development and should be expected to change.
PhysX, OpenAL, 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 (http://guildofwriters.com/tools/devlibs.zip) or can be built using their individual build instructions.
All other required libraries are available as precompiled binaries and associated files in the development libraries bundle (http://guildofwriters.org/tools/devlibs.zip) or can be built using their individual build instructions.
Compiling Instructions
----------------------
Currently, compilation only targets Windows systems and requires Visual Studio 2008 or Visual Studio 2010 (including Express Editions).
Currently, compilation only targets Windows systems and requires Visual Studio 2010 or Visual Studio 2012 (including Express Editions).
To compile:
#) Start CMake-GUI
#) Set the Where is the source code option to the location where you cloned the repository.
#) Set the Where to build the binaries option to a subfolder of the aforementioned location called build.
#) Check the Grouped and Advanced options.
#) Press Configure. Select Visual Studio 9 2008 (or your preferred version of Visual Studio) as the generator.
#) Set the CMAKE_INSTALL_PREFIX option under CMAKE to the cwe-prefix folder that you extracted from the development libraries bundle (http://guildofwriters.com/tools/devlibs.zip).
#) Press Configure again.
#) Set the OpenAL include and library path options under OpenAL.
- **Default Include Path**: C:\\Program Files\\OpenAL 1.1 SDK\\include
- **Default Library Path**: C:\\Program Files\\OpenAL 1.1 SDK\\lib\\win32\\OpenAL32.lib
#) Press Configure again.
#) Set the PHYSX_SDK_PATH option under PHYSX. The default value is C:\\Program Files\\AGEIA Technologies\\AGEIA PhysX SDK\\v2.6.4\\SDKs.
#) Press Configure... For the last time!
#) Press Generate. You will now have a Visual Studio solution file (.sln) in the folder that you specified to build the binaries in.
#) Open the solution in Visual Studio. You can compile CyanWorlds.com Engine by pressing Build -> Build Solution. This will take some time.
#) Start **CMake-GUI**.
#) Set the *Where is the source code* option to the location where you cloned the repository.
#) Set the *Where to build the binaries* option to a subfolder of the aforementioned location called *build*.
#) Check the **Grouped** and **Advanced** options.
#) Press **Configure**. Select *Visual Studio 10* (or your preferred version of Visual Studio) as the generator.
#) Set the *CMAKE_INSTALL_PREFIX* option under CMAKE to the *cwe-prefix* folder that you extracted from the development libraries bundle (http://guildofwriters.org/tools/devlibs.zip).
#) Press **Configure** again.
#) Set the *OpenAL include and library path* options under OPENAL.
- Default Include Path: ``C:\Program Files\OpenAL 1.1 SDK\include``
- Default Library Path: ``C:\Program Files\OpenAL 1.1 SDK\lib\win32\OpenAL32.lib``
#) Press **Configure** again.
#) Set the *PHYSX_SDK_PATH* option under PHYSX. The default value is ``C:\Program Files\AGEIA Technologies\AGEIA PhysX SDK\v2.6.4\SDKs``.
#) Press **Configure**... For the last time!
#) Press **Generate**. You will now have a Visual Studio solution file (.sln) in the folder that you specified to build the binaries in.
#) 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 (https://github.com/H-uru/moul-scripts). If you followed the instructions above and built against Python 2.7, be sure to pull and use the python27 branch of moul-scripts.
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 (https://github.com/H-uru/moul-scripts).
#) 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.
#) 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.
#) 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.
#) 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.
#) Copy the resource.dat file from <build_dir>\\Sources\\Plasma\\Apps\\plClient\\external to the MOUL-OS folder, or from http://www.guildofwriters.com/tools/resource.dat if you did not build your own.
#) Create a shortcut in the MOUL-OS folder to the compiled plClient.exe.
#) 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.
#) Double-click the shortcut to connect to your server and test!
#) 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.
#) 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.
#) 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.
#) 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.
#) 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.
#) Create a **shortcut** in the *MOUL-OS* folder to the compiled plClient.exe.
#) 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.
#) 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:
#) Open the Plasma Solution in Visual Studio.
#) Right-click on the plClient project in the Solution Explorer.
#) Select Configuration Properties->Debugging.
#) Enter /LocalData In the Command Arguments field.
#) Enter your MOUL-OS folder path in the Working Directory field.
#) Select *Configuration Properties->Debugging*.
#) Enter ``/LocalData`` in the *Command Arguments* field.
#) Enter your *MOUL-OS* folder path in the *Working Directory* field.
Additional Information
----------------------
- Myst Online is available to play for free at http://mystonline.com/play/
- For more information on this fork and more in-depth building instructions, see the Guild of Writers wiki: http://guildofwriters.com/wiki/Development:CyanWorlds.com_Engine.
- For more information on this fork and more in-depth building instructions, see the Guild of Writers wiki: http://guildofwriters.org/wiki/Development:CyanWorlds.com_Engine.
- This code was forked from the initial release repository at OpenUru.org: http://openuru.org/
About Non-Free Libraries
@ -114,7 +117,7 @@ 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)."
product includes software written by Tim J. Hudson (tjh@cryptsoft.com).
Independent JPEG Group (IJG) JPEG Library
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Write Preview
Loading…
Cancel
Save