EXW Docs - User contributions [en]

Getting Started

2026-06-07T00:32:37Z

Unknown025: /* Adding a gun */

= Setting up your development environment =
To get started, you'll need to download and install Java JDK 8 and IntelliJ (or a Java compatible IDE of your choice, but we'll focus on IntelliJ here - the community edition is free). You will also need a copy of Minecraft Forge's MDK for Minecraft 1.12. I ''highly encourage'' using Minecraft Forge 1.12 instead of 1.12.2. You do not need knowledge of programming or Java to complete this tutorial, but it is helpful.

Once you have the MDK downloaded, extract the contents into a directory of your choice. The name of the directory will be your project name. For the context of this tutorial, we'll use "Example Pack" as our project name. Open the directory in IntelliJ, and allow for the project to be imported. You may need to update Gradle to a supported version in the <code>gradle/wrapper</code> directory inside the project, such as <code>https\://services.gradle.org/distributions/gradle-4.9-bin.zip</code>. Your gradle-wrapper.properties file should look as follows.

<pre>
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-4.9-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
</pre>

Ensure the project loads without any errors. Warnings are expected, as Forge 1.12 is a bit old. On the right side, open the Gradle side menu. Look for the "forgegradle" dropdown, and select <code>setupDecompWorkspace</code>. This will download all the files for Minecraft to run in our development environment. Once that task completes, run <code>genIntellijRuns</code>. This will create two run tasks (visible in the top right of IntelliJ's interface, next to the green run triangle). If you see a miniature "X" next to the task, click the task dropdown, select edit, and ensure that JDK 8 and the ''main'' module are selected.

Run Minecraft and ensure the game loads. You should be able to see the game run without any problems, and an example mod contained inside.

Now, open the <code>build.gradle</code> file inside the project directory. We'll need to make a few edits here. After the <code>buildscript</code> section, we'll insert the following:
<pre>
repositories {
maven {
name = "Rainyville Maven"
url = "https://maven.rainyville.org"
}
}
</pre>

Then in the dependencies block, we'll add <code>deobfCompile 'org.rainyville.modulus:expansive-weaponry:1.12-1.1.9'</code>. You may need to run <code>setupDecompWorkspace</code> after these changes to ensure that Expansive Weaponry is downloaded. Your <code>build.gradle</code> should look something like this:

<syntaxhighlight lang="kotlin">
buildscript {
repositories {
jcenter()
maven { url = "https://maven.minecraftforge.net/" }
}
dependencies {
classpath 'net.minecraftforge.gradle:ForgeGradle:2.3-SNAPSHOT'
}
}

repositories {
maven {
name = "Rainyville Maven"
url = "https://maven.rainyville.org"
}
}
apply plugin: 'net.minecraftforge.gradle.forge'
//Only edit below this line, the above code adds and enables the necessary things for Forge/EXW to be setup.

version = "1.0"
group = "com.yourname.modid"
archivesBaseName = "modid"

sourceCompatibility = targetCompatibility = '1.8' // Need this here so eclipse task generates correctly.
compileJava {
sourceCompatibility = targetCompatibility = '1.8'
}

minecraft {
version = "1.12.2-14.23.5.2847"
runDir = "run"
mappings = "snapshot_20171003"
}

dependencies {
deobfCompile 'org.rainyville.modulus:expansive-weaponry:1.12-1.1.9'
}
</syntaxhighlight>
= Creating a pack =
Now that we have both Forge and Expansive Weaponry loaded in a development environment, we can create our content pack. You'll notice that when you run Minecraft from within IntelliJ, all the game files are located in the <code>run</code> subdirectory in our project. Inside, there is an <code>Expansive Weaponry</code> directory. We'll create our content pack by creating a new subdirectory inside, named "Example Pack". It should be located inside <code>Example Pack/run/Expansive Weaponry/Example Pack</code> (replace with your own pack name as applicable).

Now, create a new file named <code>exwpack.info</code>. This will contain some basic properties for our content pack. All the fields are documented at [[EXWPack.info]], but as a minimum we'll need our pack ID, version, and target API.
<syntaxhighlight lang="json">
{
"packId": "epack",
"authorList": [],
"url": "https://docs.exw.rainyville.org/Getting_Started",
"version": "1.0.0",
"logo": "logo.png",
"name": "Example Pack",
"description": "This is a description that'll be displayed in the main menu.",
"credits": "Thanks to the wonderful tutorial author.",
"targetAPI": "2.0.0",
"creativeTabIcon": "diamond_sword"
}
</syntaxhighlight>
At this point, if we load the game, you'll see the example pack shows up in the content pack list.
= Adding a gun =
Finally we get to the fun part: adding items. We'll add an AKM into the game. First step, in our content pack directory (inside the <code>Expansive Weaponry</code> directory) we'll create a directory named <code>guns</code>. Inside the new directory, we'll create a file named <code>epack.akm.json</code>. It is strongly encouraged to name your JSON files as <code><pack ID>.<item name>.json</code>. Inside our newly created JSON file, we can now fill out some parameters for our gun (which can be found at [[GunType]]). Here's an example:
<syntaxhighlight lang="json">
{
"modelName": "epack.ModelAKM",
"maxStackSize": 1,
"internalName": "epack.akm",
"displayName": "AKM",
"iconName": "epack.akm",
"gunDamage": 8,
"roundsPerMin": 500,
"recoilPitch": 8,
"recoilYaw": 5,
"randomRecoilPitch": 0.5,
"randomRecoilYaw": 0.5,
"crouchRecoilModifier": 0.8,
"bulletSpread": 2.0,
"fireModes": [
"full",
"semi"
],
"reloadTime": 60,
"acceptedAmmo": [
"epack.30rnd76239"
],
"allowDefaultSounds": true,
"emptyPitch": 0.05,
"weaponSoundMap": {
"weaponFire": [
{
"soundEvent": "weaponFire",
"soundName": "epack.ak103.fire",
"soundNameDistant": "epack.ak103.firedist",
"soundRange": 64,
"soundMaxRange": 96,
"soundFadeMultiplier": 1
}
],
"weaponFireSuppressed": [
{
"soundEvent": "weaponFireSuppressed",
"soundName": "epack.ak103.firesupp",
"soundRange": 30,
"soundMaxRange": 30,
"soundFadeMultiplier": 1
}
],
"magIn": [
{
"soundEvent": "magIn",
"soundName": "epack.ak103.magin"
}
],
"magOut": [
{
"soundEvent": "magOut",
"soundName": "epack.ak103.magout"
}
],
"rack": [
{
"soundEvent": "rack",
"soundName": "epack.ak103.rack"
}
]
}
</syntaxhighlight>
While this may look complicated, you can actually copy this file and edit the fields instead of typing everything out from scratch. Make sure you update all the names for the model name, internal name, sounds, and the accepted ammo.

Getting Started

2026-06-07T00:32:21Z

Unknown025: Added section on how to create the pack.

Getting Started

2026-06-07T00:12:51Z

Unknown025: Created basic tutorial to configure development environment for pack dev.

= Creating a new content pack =
To get started, you'll need to download and install Java JDK 8 and IntelliJ (or a Java compatible IDE of your choice, but we'll focus on IntelliJ here - the community edition is free). You will also need a copy of Minecraft Forge's MDK for Minecraft 1.12. I ''highly encourage'' using Minecraft Forge 1.12 instead of 1.12.2.

Once you have the MDK downloaded, extract the contents into a directory of your choice. The name of the directory will be your project name. For the context of this tutorial, we'll use "Example Pack" as our project name. Open the directory in IntelliJ, and allow for the project to be imported. You may need to update Gradle to a supported version in the <code>gradle/wrapper</code> directory inside the project, such as <code>https\://services.gradle.org/distributions/gradle-4.9-bin.zip</code>. Your gradle-wrapper.properties file should look as follows.

<pre>
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-4.9-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
</pre>

Ensure the project loads without any errors. Warnings are expected, as Forge 1.12 is a bit old. On the right side, open the Gradle side menu. Look for the "forgegradle" dropdown, and select <code>setupDecompWorkspace</code>. This will download all the files for Minecraft to run in our development environment. Once that task completes, run <code>genIntellijRuns</code>. This will create two run tasks (visible in the top right of IntelliJ's interface, next to the green run triangle). If you see a miniature "X" next to the task, click the task dropdown, select edit, and ensure that JDK 8 and the ''main'' module are selected.

Run Minecraft and ensure the game loads. You should be able to see the game run without any problems, and an example mod contained inside.

Now, open the <code>build.gradle</code> file inside the project directory. We'll need to make a few edits here. After the <code>buildscript</code> section, we'll insert the following:
<pre>
repositories {
maven {
name = "Rainyville Maven"
url = "https://maven.rainyville.org"
}
}
</pre>

Then in the dependencies block, we'll add <code>deobfCompile 'org.rainyville.modulus:expansive-weaponry:1.12-1.1.9'</code>. You may need to run <code>setupDecompWorkspace</code> after these changes to ensure that Expansive Weaponry is downloaded. Your <code>build.gradle</code> should look something like this:

<syntaxhighlight lang="kotlin">
buildscript {
repositories {
jcenter()
maven { url = "https://maven.minecraftforge.net/" }
}
dependencies {
classpath 'net.minecraftforge.gradle:ForgeGradle:2.3-SNAPSHOT'
}
}

repositories {
maven {
name = "Rainyville Maven"
url = "https://maven.rainyville.org"
}
}
apply plugin: 'net.minecraftforge.gradle.forge'
//Only edit below this line, the above code adds and enables the necessary things for Forge/EXW to be setup.

version = "1.0"
group = "com.yourname.modid"
archivesBaseName = "modid"

sourceCompatibility = targetCompatibility = '1.8' // Need this here so eclipse task generates correctly.
compileJava {
sourceCompatibility = targetCompatibility = '1.8'
}

minecraft {
version = "1.12.2-14.23.5.2847"
runDir = "run"
mappings = "snapshot_20171003"
}

dependencies {
deobfCompile 'org.rainyville.modulus:expansive-weaponry:1.12-1.1.9'
}
</syntaxhighlight>

AmmoType

2026-06-04T08:20:03Z

Unknown025: /* AmmoType (extends BaseType) */

== AmmoType (extends [[BaseType]]) ==
For each type, the table lists each field, type, default value (if applicable), and definition.
{| class="wikitable" style="margin:auto; width: 100%"
|-
! Field !! Type !! Default !! Definition
|-
| numBullets || int || 1 || Number of bullets fired per shot.
|-
| ammoCapacity || int || 30 || Ammo capacity amount.
|-
| magazineCount || Integer || - || Magazine count.
|-
| reloadTime || float || - || Number of seconds it should take to reload.
|-
| recoilPitch || float || 0.0F || Base value for upwards cursor/view recoil.
|-
| recoilYaw || float || 0.0F || Base value for left/right cursor/view recoil.
|-
| bulletDamage || float || 1 || Damage inflicted per bullet, multiplied by the gun damage value.
|-
| bulletSpread || float || - || The amount that bullets spread out when fired.
|-
| emptyOnCraft || boolean || false || Will this ammo item be loaded or empty when crafted?
|-
| allowEmptyMagazines || boolean || true || Override ammo deletion, to allow for enabling or disabling of returned empty magazines.
|-
| refillCost || [[JsonItemStack]][] || <code>[{"id": "gunpowder", "count": 2}]</code> || Cost to refill this magazine, per each missing bullet. Set to null to disable magazine refilling.
|-
| subAmmo || String[] || - || The ammo type(s) that can be loaded into this item.
|-
| potionEffects || [[PotionEntry]][] || - || Array of potion effects applied to an entity upon bullet impact.
|-
| explosionSize || Integer || null || When set and greater than zero, this will cause an explosion on impact with a block.
|-
|}

EXWPack.info

2026-06-04T08:07:00Z

Unknown025: Created EXWPack.info page.

== EXWPack.info ==
This file defines basic metadata for your content pack.

As of v1.2.0, this file will be ''required'' for your content pack to be loaded.

{| class="wikitable" style="margin:auto; width: 100%"
|-
! Field !! Type !! Default !! Required || Definition
|-
| packId || String || - || YES || This pack's '''unique''' identifier. Please make sure this is a unique ID value. Must be all lowercase, with no spaces or special characters.
|-
| authorList || String[] || [] || || List of authors for this pack.
|-
| url || String || "" || || URL for this pack's website.
|-
| version || String || "1.0.0" || YES || This pack's version.
|-
| logo || String || "" || || This pack's logo file.
|-
| name || String || "" || || Name of this pack.
|-
| credits || String || "" || || Credits/description for this pack.
|-
| targetAPI || String || - || YES || The target API this content pack is compatible with. Please see the [https://exw.rainyville.org/dev/api-targets API targets page] for more details.
|-
| creativeTabIcon || String || - || || The item ID to set as the creative tab icon.
|}

BaseType

2026-06-04T07:49:50Z

Unknown025: /* BaseType */

== BaseType ==
For each type, the table lists each field, type, default value (if applicable), and definition.
{| class="wikitable" style="margin:auto; width: 100%"
|-
! Field !! Type !! Default !! Definition
|-
| modelName || String || - || Name of the model for this item.
|-
| <s>modelLocation</s> || String || - || Location of the Wavefront OBJ file, stemming from "assets/exw/wavefront/<object type>/"
Deprecated: Use modelName to specify the name of your model file.
|-
| <s>loadWavefront</s> || Boolean || false || Whether this type should try to load a Wavefront OBJ model from modelLocation.
Deprecated: Use ModelType to determine which type of model this item has.
|-
| modelType || [[ModelType]] || ModelType.TOOLBOX || Determines which type of model will be loaded.
|-
| maxStackSize || Integer || - || The maximum stack size for this item. (If not specified, a default value will be used depending on the type.)
|-
| modelSkins || [[SkinType]][] || - || The skins available for this item.
|-
| internalName || String || - || The unlocalized name for this item.
|-
| displayName || String || - || The display name for this item.
|-
| iconName || String || - || The name of the icon for this item.
|-
|}

SkinType

2026-06-04T07:48:57Z

Unknown025: Created SkinType page.

== BaseType ==
For each type, the table lists each field, type, default value (if applicable), and definition.
{| class="wikitable" style="margin:auto; width: 100%"
|-
! Field !! Type !! Default !! Definition
|-
| <s>internalName</s> || String || - || (Deprecated) Unlocalized name for this item.
|-
| displayName || String || - || The display name for this item.
|-
| skinAsset || String || - || Location of the skin asset.
|-
| <s>requiredItems</s> || String[] || - || (Deprecated) Not implemented.
|-
|}

ModelType

2026-06-04T07:45:43Z

Unknown025: Created ModelType page.

== ModelType ==
The following are available values that apply to any field requiring the parameter <code>ModelType</code>.
{| class="wikitable" style="margin:auto; width: 100%"
|-
! Name !! Directory !! File Extension
|-
| TOOLBOX || - || -
|-
| WAVEFRONT || wavefront || obj
|-
| METASEQUOIA || metaseq || mqo
|-
|}

== Where your models should go ==

=== Toolbox ===
Toolbox models go into the Java package <code>org.rainyville.modulus.client.model</code>. It is best practice to create your own package inside, such as <code>org.rainyville.modulus.client.model.w44</code>.

=== Wavefront ===
OBJ models go into your content pack's assets folder. For example, if your content pack is named "Modern Warfare" and you're adding a vehicle model, it would go into <code>Modern Warfare/assets/exw/wavefront/vehicles</code>.

=== Metasequoia ===
Metaequoia models follow the same format as OBJ models, except instead of "wavefront", models go into a "metaseq" folder, such as <code>Modern Warfare/assets/exw/metaseq/vehicles</code>.

BaseType

2026-06-04T07:38:13Z

Unknown025: Created BaseType page.

== BaseType ==
For each type, the table lists each field, type, default value (if applicable), and definition.
{| class="wikitable" style="margin:auto; width: 100%"
|-
! Field !! Type !! Default !! Definition
|-
| modelName || String || - || Name of the model for this item.
|-
| modelLocation || String || - || Location of the Wavefront OBJ file, stemming from "assets/exw/wavefront/<object type>/"
Deprecated: Use modelName to specify the name of your model file.
|-
| loadWavefront || Boolean || false || Whether this type should try to load a Wavefront OBJ model from modelLocation.
Deprecated: Use ModelType to determine which type of model this item has.
|-
| modelType || [[ModelType]] || ModelType.TOOLBOX || Determines which type of model will be loaded.
|-
| maxStackSize || Integer || - || The maximum stack size for this item. (If not specified, a default value will be used depending on the type.)
|-
| modelSkins || [[SkinType]][] || - || The skins available for this item.
|-
| internalName || String || - || The unlocalized name for this item.
|-
| displayName || String || - || The display name for this item.
|-
| iconName || String || - || The name of the icon for this item.
|-
|}

AmmoType

2026-06-04T04:42:32Z

Unknown025: /* AmmoType (extends BaseType) */

== AmmoType (extends [[BaseType]]) ==
For each type, the table lists each field, type, default value (if applicable), and definition.
{| class="wikitable" style="margin:auto; width: 100%"
|-
! Field !! Type !! Default !! Definition
|-
| numBullets || int || 1 || Number of bullets fired per shot.
|-
| ammoCapacity || int || 30 || Ammo capacity amount.
|-
| magazineCount || Integer || - || Magazine count.
|-
| reloadTime || float || - || Number of seconds it should take to reload.
|-
| recoilPitch || float || 0.0F || Base value for upwards cursor/view recoil.
|-
| recoilYaw || float || 0.0F || Base value for left/right cursor/view recoil.
|-
| bulletDamage || float || 1 || Damage inflicted per bullet, multiplied by the gun damage value.
|-
| bulletSpread || float || - || The amount that bullets spread out when fired.
|-
| emptyOnCraft || boolean || false || Will this ammo item be loaded or empty when crafted?
|-
| allowEmptyMagazines || boolean || true || Override ammo deletion, to allow for enabling or disabling of returned empty magazines.
|-
| refillCost || JsonItemStack[] || [{"id": "gunpowder", "count": 2}] || Cost to refill this magazine, per each missing bullet. Set to null to disable magazine refilling.
|-
| subAmmo || String[] || - || The ammo type(s) that can be loaded into this item.
|-
| potionEffects || PotionEntry[] || - || Array of potion effects applied to an entity upon bullet impact.
|-
| explosionSize || Integer || null || When set and greater than zero, this will cause an explosion on impact with a block.
|-
|}

AmmoType

2026-06-04T04:34:36Z

Unknown025: Created page with "== AmmoType (extends BaseType) == For each type, the table lists each field, type, default value (if applicable), and definition. {| class="wikitable" style="margin:auto; width: 100%" |- ! Field !! Type !! Default !! Definition |- | numBullets || int || 1 || Number of bullets fired per shot. |}"

Main Page

2026-06-04T04:28:36Z

Unknown025: Updated page to be more uniform.

{{Box|
BORDER = #9999FF|
BACKGROUND = #99CCFF|
WIDTH = 100%|
ICON = |
HEADING = Expansive Weaponry Documentation |
CONTENT =
Welcome to the new home of the Expansive Weaponry docs!

=== Downloads ===
* [https://exw.rainyville.org/downloads Official website]
* [https://www.curseforge.com/minecraft/mc-mods/expansive-weaponry/ CurseForge]
<small>Please report any other downloads to the mod creators.</small>

=== Creating a content pack ===
* [[Getting Started]]

=== Reference ===
The following is a list of all fields, default values, and descriptions for all applicable configurable content.

* [[AmmoType]]
* [[ArmorInfo]]
* [[ArmorType]]
* [[AttachmentEnum]]
* [[BackpackInfo]]
* [[BaseType]]
* [[CraftOption]]
* [[CraftingType]]
* [[GunType]]
* [[JsonItemStack]]
* [[MArmorType]]
* [[PotionEffectEnum]]
* [[PotionEntry]]
* [[RecordType]]
* [[SeatInfo]]
* [[SkinType]]
* [[SoundEntry]]
* [[SoundType]]
* [[TankType]]
* [[VehicleType]]
* [[WeaponFireMode]]
* [[WeaponScopeType]]
* [[WeaponType]]
* [[EXWPack.info]]

==== Model Reference ====
* [[ModelConfig]]
* [[ModelTransform]]
* [[TransformType]]
* [[Vector3f]]
}}

Template:Box

2026-06-04T04:24:52Z

Unknown025: Created page with "{| width={{{WIDTH}}} style="border: 0; background-color: #ffffff" cellpadding="0" cellspacing="3" | style="width: {{{WIDTH}}}; vertical-align: top; border:1px solid {{{BORDER}}}; background-color: #ffffff" | <div style="background-color:{{{BACKGROUND}}}; font-size:1px; height:8px; border-bottom:1px solid {{{BORDER}}};"></div> <div style="float:right; margin:7px; margin-top:5px">{{{ICON}}}</div> <div style="padding:0.5em 0.3em 0.3em 0.3em; margin:0; text-indent:0.1em; fon..."

{| width={{{WIDTH}}} style="border: 0; background-color: #ffffff" cellpadding="0" cellspacing="3"
| style="width: {{{WIDTH}}}; vertical-align: top; border:1px solid {{{BORDER}}}; background-color: #ffffff" |
<div style="background-color:{{{BACKGROUND}}}; font-size:1px; height:8px; border-bottom:1px solid {{{BORDER}}};"></div>
<div style="float:right; margin:7px; margin-top:5px">{{{ICON}}}</div>
<div style="padding:0.5em 0.3em 0.3em 0.3em; margin:0; text-indent:0.1em; font-weight: bold; border-bottom:1px solid #aaaaaa;">{{{HEADING}}}</div>
<div style="font-size:100%; padding:3px">
{|valign=top cellpadding=0 cellspacing=3 width=100%
|align=left valign=top width=100%|
{{{CONTENT}}}
|}
</div>
|}

Main Page

2026-06-04T04:24:19Z

Unknown025: Added index summary of all documentation pages.

<strong>Expansive Weaponry Documentation</strong>

Welcome to the new home of the Expansive Weaponry docs!

== Downloads ==
* [https://exw.rainyville.org/downloads Official website]
* [https://www.curseforge.com/minecraft/mc-mods/expansive-weaponry/ CurseForge]
<small>Please report any other downloads to the mod creators.</small>

== Creating a content pack ==
* [[Getting Started]]

{{Box|
BORDER = #9999FF|
BACKGROUND = #99CCFF|
WIDTH = 100%|
ICON = |
HEADING = Expansive Weaponry Reference |
CONTENT =

The following is a list of all fields, default values, and descriptions for all applicable configurable content.

* [[AmmoType]]
* [[ArmorInfo]]
* [[ArmorType]]
* [[AttachmentEnum]]
* [[BackpackInfo]]
* [[BaseType]]
* [[CraftOption]]
* [[CraftingType]]
* [[GunType]]
* [[JsonItemStack]]
* [[MArmorType]]
* [[PotionEffectEnum]]
* [[PotionEntry]]
* [[RecordType]]
* [[SeatInfo]]
* [[SkinType]]
* [[SoundEntry]]
* [[SoundType]]
* [[TankType]]
* [[VehicleType]]
* [[WeaponFireMode]]
* [[WeaponScopeType]]
* [[WeaponType]]
* [[EXWPack.info]]

==== Model Reference ====
* [[ModelConfig]]
* [[ModelTransform]]
* [[TransformType]]
* [[Vector3f]]
}}

Main Page

2026-06-04T03:27:42Z

Unknown025: Added future link for getting started.

Main Page

2026-06-04T03:22:38Z

Unknown025: Updated main index page.