]> git.rm.cloudns.org Git - xonotic/xonotic.wiki.git/commitdiff
Add more documentation detailed and fix some missing info
authorLegendaryGuard <rootuser999@gmail.com>
Sun, 28 May 2023 22:10:59 +0000 (22:10 +0000)
committerLegendaryGuard <rootuser999@gmail.com>
Sun, 28 May 2023 22:10:59 +0000 (22:10 +0000)
SMB-modpack.md

index 163d7da0d2a6639427925f78040872929235a3a4..436e2e5239ef1badce555a661a97bfee3fb82b61 100644 (file)
@@ -1,9 +1,22 @@
-**[SMB modpack](https://github.com/MarioSMB/modpack)** project developed by **[Mario](https://github.com/MarioSMB)**.
+Developed and maintained by **[Mario](https://github.com/MarioSMB)** and **[TimePath](https://github.com/TimePath)**.
+
+The **[modpack](https://github.com/MarioSMB/modpack)** was **[TimePath](https://github.com/TimePath)**'s experiment to split "custom" features into a secluded codebase. <br/>
+It makes it used to create games based on the Xonotic template.
 
 The modpack build works using a submodule from '_xonotic-data.pk3dir_' from the official gamelogic development repository.
 
 Uses **update.sh** and **build.sh** shell script files. 
 
+You can create mods from this modpack like: 
+- **[Quake](https://github.com/MarioSMB/modpack/tree/quake)**
+<img src="uploads/a622ef2d5c0c5ca81d6f044c452293eb/quake_mod_sample.jpg" alt="quake_mod_sample" width=500 />
+
+- **[Prydon Gate](https://github.com/MarioSMB/modpack/tree/prydon)**
+<img src="uploads/2dd93a2f8ce7b22400c32535c9fad392/prydon_mod_sample.jpg" alt="prydon_mod_sample" width=500 />
+
+- **[Suwa Moriya 64](https://github.com/MarioSMB/modpack/tree/moriya)**
+<img src="uploads/33a69c4499702fbf8592766ebae04c34/suwa_moriya_64_mod_sample.jpg" alt="suwa_moriya_64_mod_sample" width=500 />
+
 # How submodule works, update.sh and build.sh
 
 Uses '_update.sh_' to obtain the content of '_gmqcc_', '_xonotic-data.pk3dir_' in '_xonotic_' folder and '_csprogs_' in '_.cache_' folder. Clearly, needs gmqcc to be able to compile, this means that '_build.sh_' calls gmqcc to compile the code.
@@ -11,37 +24,38 @@ Uses '_update.sh_' to obtain the content of '_gmqcc_', '_xonotic-data.pk3dir_' i
 ## Submodule and update.sh
 
 The submodule of this modpack was created using: 
-
-`git submodule add https://gitlab.com/xonotic/xonotic-data.pk3dir xonotic`
+```sh
+git submodule add https://gitlab.com/xonotic/xonotic-data.pk3dir xonotic
+```
 
 The submodule in the repository is used when need to update the code from '_xonotic-data.pk3dir_', to do this if you've a fork or a copy of SMB modpack repository, you'll have to update using (note: in your local computer, you should have used '_update.sh_' to download fully the content of '_xonotic-data.pk3dir_' in '_xonotic_' folder):
-
-`git submodule update --remote --merge`
+```sh
+git submodule update --remote --merge
+```
 
 It'll update the content where is in the official gamelogic development repository in your modpack repository.
 
 Inside '_update.sh_', there is a line: 
-
-`git submodule update --init --depth 100`
+```sh
+git submodule update --init --depth 100
+```
 
 Means that when you use '_update.sh_' with this line, the submodule content will be downloaded in your local computer where you've cloned the modpack repository.
 
 To run '_update.sh_' script, you should go to the current directory where is this script and execute:
-
-`./update.sh`
+```sh
+./update.sh
+```
 
 ### Commit with submodule
 
 Additionally, after done `git submodule update --remote --merge`, if you want to commit:
-
-`git status`
-
-`git add xonotic`
-
-`git commit -m "Update submodule xonotic test"`
-
-`git push origin master #depends what origin and what branch of repository you're using to do your commits`
-
+```sh
+git status
+git add xonotic
+git commit -m "Update submodule xonotic test"
+git push origin master #depends what origin and what branch of repository you're using to do your commits
+```
 ## build.sh
 
 '_build.sh_' compiles all repository code using gmqcc if already downloaded from '_update.sh_', looks inside '_mod_' folder the similar contents of '_xonotic-data.pk3dir/qcsrc_' where there are: '_client_', '_common_', '_menu_' and '_server_' folders.
@@ -49,5 +63,13 @@ Additionally, after done `git submodule update --remote --merge`, if you want to
 What this does is relate the directory path to the submodule '_xonotic_' directory inside the '_qcsrc_' folder. Thanks to this, makes possible to look at the '_mod_' folder having to relate the submodule directory '_xonotic/qcsrc_'.
 
 To run '_build.sh_' script, you should go to the current directory where is this script and execute:
+```sh
+./build.sh
+```
+
+For speed up compilation, you can run with:
+```sh
+ZIP=: ./build.sh
+```
 
-`./build.sh`
\ No newline at end of file
+That executes without compression (without getting `csprogs-*.pk3` file).
\ No newline at end of file