From 097f665a6e2313f9fc555f7119cb030ed4bf87d1 Mon Sep 17 00:00:00 2001 From: Patrix Date: Fri, 8 Mar 2024 22:21:08 +0100 Subject: [PATCH] Updated README.md --- README.md | 130 ++++-------------------------------------------------- 1 file changed, 8 insertions(+), 122 deletions(-) diff --git a/README.md b/README.md index 17efc79..aef908b 100644 --- a/README.md +++ b/README.md @@ -1,127 +1,13 @@ # Squirrel module template -## Table of contents +## Introduction -- [Usage requirements](#usage-requirements) -- [Installing module](#installing-module) -- [Loading module](#loading-module) -- [Build requirements](#build-requirements) -- [Build instructions](#build-instructions) -- [CMake options](#cmake-options) +This is a template project for making squirrel modules for [Gothic 2 Online](https://gothic-online.com.pl/) modification. +The template uses: +- **CMake** to support **Windows** and **Linux** systems + specific architectures. +- **gitlab-ci** for easier release of new module versions. +- **MkDocs** for generating and hosting web documentation. -## Usage requirements +## Documentation -This package is essential only for **Windows** platform, and it is installed by default by g2o installer. \ -In order to use the module, the user have to install: \ -[Microsoft Visual C++ 2015-2022 Redistributable (x86)](https://aka.ms/vs/17/release/vc_redist.x86.exe) - -## Installing module - -**_NOTE:_** Client modules aren't downloaded by default by g2o server. -You have to put them manually into: `Game/Multiplayer/Modules` directory. - -In order to install the module you can either [download the prebuilt binary](../../releases) from releases, or [build the module yourself](#build-instructions). -Be sure to install the module with matching CPU architecture for your server app. - -## Loading module - -To load the module, you have to put `` tag into .xml server configuration. -Below you can find more info about this tag **attributes**. - -```xml - - - - - src="path/to/the/module" - - type="client"|"server" - - - - md5="1a79a4d60de6718e8e5b326e338ae533" - - - - required=true|false -``` - -Example of loading client module: -```xml - -``` - -Example of loading server module: -```xml - -``` - -## Build requirements - -**_NOTE:_** Some of the requirements like _IDE_ or _compiler_ are just recommendation - -In order to compile the module, you have to meet some \ -essential requirements, -depending on the target platform. - -### Windows - -- Visual Studio, 2015+ (recommended [2019 Community Edition](https://visualstudio.microsoft.com/pl/thank-you-downloading-visual-studio/?sku=Community&rel=16)) - - Visual Studio Components - * Windows SDK - * one of the following toolsets, pick one: v140, v141, v142 (recommended v142) - * (Optional) CMake Tools for Visual Studio -- [CMake 3.17+](https://cmake.org/download/) - -### Linux - -- g++ compiler -- [CMake 3.17+](https://cmake.org/download/) - -## Build instructions - -### Windows - -#### Visual Studio with CMake tools - -- open a local folder using Visual Studio -- build the project - -#### Visual Studio without CMake tools - -- open command line in repo-directory -- type ``mkdir build`` -- type ``cd build`` -- type ``cmake ..`` -- open visual studio .sln and compile the project -- alternatively if you want to build from command line instead, \ - type ``cmake --build .`` - -### Linux - -- open terminal in repo-directory -- type ``mkdir build`` -- type ``cd build`` -- type ``cmake ..`` -- type ``cmake --build .`` - -## CMake options - -This project has some configurable options. - -### Cache options - -Cache options are stored inside **CMakeCache.txt** inside generated CMake build folder. -You can set these options, by either manually editing the file, or by using cmake-gui. - -- **GAME_PATH** this cache option allows you to setup the destination - where module will be installed. If it's set to some value, it will - generate an installation step. by default it's set to ``""`` (disabled). - -- **SERVER_PATH** this cache option allows you to setup the destination - where module will be installed. If it's set to some value, it will - generate an installation step. by default it's set to ``""`` (disabled). - -- **INSTALL_AFTER_BUILD** this cache option allows you to run - cmake install step after a successfull build. By default it's disabled. +https://gothicmultiplayerteam.gitlab.io/modules/squirrel-template \ No newline at end of file