iw2d · MujyKun · Sep 23, 2025 · Sep 23, 2025 · Oct 9, 2025 · Oct 9, 2025
diff --git a/.env.example b/.env.example
@@ -0,0 +1,32 @@
+# This example shows a setup for Cassandra on Prod
+
+# cassandra, postgres
+DB_TYPE=cassandra
+
+# DEV ENV
+TESPIA=FALSE
+
+# DOCKERIZED JAVA SERVER
+DB_HOST=cassandra_kinoko
+# DB_HOST=postgres_kinoko
+
+# LOCAL (Undockerized) JAVA SERVER (DB SERVER CAN BE DOCKERIZED)
+# DB_HOST=localhost
+
+# Cassandra Settings
+DB_DATACENTER="datacenter1"
+DB_PROFILE_ONE="profile_one"
+
+DB_PORT=9042
+# DB_PORT=5432
+
+# DB NAME (Cassandra Keyspace, or Postgres Database Name)
+DB_NAME=kinoko
+
+
+# Postgres Settings
+DB_USER=postgres
+DB_PASS=admin
+
+
+# Any other env settings you want to modify:
diff --git a/.gitignore b/.gitignore
@@ -2,6 +2,7 @@ target/
 !.mvn/wrapper/maven-wrapper.jar
 !**/src/main/**/target/
 !**/src/test/**/target/
+*.env
 
 ### IntelliJ IDEA ###
 .idea/modules.xml
@@ -42,4 +43,5 @@ build/
 
 ### Project ###
 /wz/
+/wz/*.wz
 /json/
diff --git a/Dockerfile b/Dockerfile
@@ -6,6 +6,9 @@ WORKDIR /kinoko
 COPY pom.xml .
 RUN mvn dependency:go-offline
 
+# not sure why this was left out originally, if it's needed to pass tests to build the JAR.
+COPY wz ./wz
+
 COPY src ./src
 RUN mvn clean package
 

diff --git a/README.md b/README.md
@@ -8,8 +8,14 @@ Basic configuration is available via environment variables - the names and defau
 are defined in [ServerConstants.java](src/main/java/kinoko/server/ServerConstants.java)
 and [ServerConfig.java](src/main/java/kinoko/server/ServerConfig.java).
 
+### Client Downloads
+[GMS V95 Client Setup](https://ia600809.us.archive.org/19/items/GMSSetup93-133/GMS0095/GMSSetupv95.exe)  
+[GMS v95.1 Localhost](https://mega.nz/file/dWIgyR4I#6cDN_ycLLiFtad07Eby3UfjdY3TqGI65g6X-xEqlmds)
+
+
+
 > [!NOTE]
-> Client WZ files are expected to be present in the `wz/` directory in order for the provider classes to extract the
+> Client .WZ files are expected to be present in the `wz/` directory in order for the provider classes to extract the
 > required data. The required files are as follows:
 > ```
 > Character.wz
@@ -25,6 +31,7 @@ and [ServerConfig.java](src/main/java/kinoko/server/ServerConfig.java).
 > Etc.wz
 > ```
 
+
 #### Java setup
 
 Building the project requires Java 21 and maven.
@@ -34,16 +41,35 @@ Building the project requires Java 21 and maven.
 $ mvn clean package
 ```
 
+#### Environment setup
+Before doing any Docker or Database Setup
+You should:
+1. Make a copy of `.env.example` and rename it to `.env`
+2. Adjust the ENV Variables to the database server you will be using.
+
+
 #### Database setup
 
-It is possible to use either CassandraDB or ScyllaDB, no setup is required other than starting the database.
+It is possible to use either CassandraDB, ScyllaDB, or Postgres.
+
 
 ```bash
 # Start CassandraDB
+$ docker-compose up -d cassandra
+# OR 
 $ docker run -d -p 9042:9042 cassandra:5.0.0
 
 # Alternatively, start ScyllaDB
 $ docker run -d -p 9042:9042 scylladb/scylla --smp 1
+
+# Alternatively, start PostgreSQL 
+$ docker-compose up -d postgres
+# OR (CHANGE THE PASSWORD)
+$ docker run -d --name postgres_kinoko -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=admin -e POSTGRES_INITDB_ARGS="--auth-host=scram-sha-256 --auth-local=scram-sha-256" -e POSTGRES_DB=kinoko -p 5432:5432 -v "${PWD}\src\main\java\kinoko\database\postgresql\setup\init.sql:/docker-entrypoint-initdb.d/init.sql:ro" postgres:16
+
+Important: If you are using PostgreSQL on a local machine (not using a dockerized server), 
+make sure that you have any undockerized postgresql server offline. This can cause conflicts. 
+
 ```
 
 You can use [Docker Desktop](https://www.docker.com/products/docker-desktop/) or WSL on Windows.
@@ -58,5 +84,11 @@ the [docker-compose.yml](docker-compose.yml) file. The requirements are as follo
 
 ```bash
 # Build and start containers
-$ docker compose up -d
+
+# Cassandra & Server (Recommended, default)
+$ docker compose up -d cassandra server
+
+# Postgres & Server (Alternative)
+$ docker compose up -d postgres server
+
 ```
diff --git a/data/reward/100005.yaml b/data/reward/100005.yaml
@@ -16,4 +16,4 @@ rewards:
   - [ 2061000, 10, 20, 0.008000 ] # Arrow for Crossbow
   - [ 4000003, 1, 1, 0.400000 ] # Tree Branch
   - [ 4010003, 1, 1, 0.002000 ] # Adamantium Ore
-  - [ 4020003, 1, 1, 0.002000 ] # Emerald Ore
+  - [ 4020003, 1, 1, 0.002000 ] # Emerald Ore
diff --git a/data/reward/100200.yaml b/data/reward/100200.yaml
@@ -0,0 +1,4 @@
+# Mob 100200 (100200)
+
+rewards:
+- [4033072, 1, 1, 0.999999]
diff --git a/data/reward/1110101.yaml b/data/reward/1110101.yaml
@@ -27,4 +27,5 @@ rewards:
   - [ 4032460, 1, 1, 0.050000, 22529 ] # Refreshing Stump Sap
   - [ 4032374, 1, 1, 0.035000, 2405 ] # Letter of Commendation - Warrior Adventurer
   - [ 4032376, 1, 1, 0.035000, 2406 ] # Letter of Commendation - Magician Adventurer
-  - [ 4001371, 1, 1, 0.035000, 28261, 101010102 ] # Ripped Paper 5
+  - [ 4001371, 1, 1, 0.035000, 28261, 101010102 ] # Ripped Paper 5
+  - [ 4032624, 1, 1, 0.500000, 2380 ] # Dark Stump's Dual Blade Seal (Quest 2380 - Sixth Mission: Destroying the Evidence 4)
diff --git a/data/reward/1110130.yaml b/data/reward/1110130.yaml
@@ -32,3 +32,6 @@ rewards:
   - [ 4010004, 1, 1, 0.002000 ] # Silver Ore
   - [ 4020002, 1, 1, 0.002000 ] # AquaMarine Ore
   - [ 4020003, 1, 1, 0.002000 ] # Emerald Ore
+  - [ 4032316, 1, 1, 1.000000, 21714 ] # Green Mushroom Puppet (Quest 21714 - Aran)
+  - [ 4032317, 1, 1, 1.000000, 21717 ] # Green Mushroom Puppet (Quest 21717 - Rowen's Request 1 - Aran)
+  - [ 4032318, 1, 1, 1.000000, 21718 ] # Green Mushroom Puppet (Quest 21718 - Rowen's Request 2 - Aran)
diff --git a/data/reward/1120100.yaml b/data/reward/1120100.yaml
@@ -19,3 +19,4 @@ rewards:
   - [ 4010003, 1, 1, 0.002000 ] # Adamantium Ore
   - [ 4020002, 1, 1, 0.002000 ] # AquaMarine Ore
   - [ 4032378, 1, 1, 0.035000, 2408 ] # Letter of Commendation - Thief Adventurer
+  - [ 4032622, 1, 1, 0.500000, 2359 ] # Octopus Dual Blade Seal (Quest 2359 - Sixth Mission: Destroying the Evidence)
diff --git a/data/reward/1210100.yaml b/data/reward/1210100.yaml
@@ -20,5 +20,6 @@ rewards:
   - [ 4000021, 1, 1, 0.040000 ] # Leather
   - [ 4010006, 1, 1, 0.002000 ] # Gold Ore
   - [ 4020006, 1, 1, 0.002000 ] # Topaz Ore
+  - [ 4032340, 1, 1, 1.000000, 21710 ] # Pig tail (Quest 21710: A Monster War?)
   - [ 4032453, 1, 1, 0.400000, 22503 ] # Pork
   - [ 4032379, 1, 1, 0.035000, 2409 ] # Letter of Commendation - Pirate Adventurer
diff --git a/data/reward/1210103.yaml b/data/reward/1210103.yaml
@@ -27,3 +27,4 @@ rewards:
   - [ 4006000, 1, 1, 0.000700 ] # The Magic Rock
   - [ 4010002, 1, 1, 0.002000 ] # Mithril Ore
   - [ 4020005, 1, 1, 0.002000 ] # Sapphire Ore
+  - [ 4032621, 1, 1, 0.500000, 2378 ] # Bubbling's Dual Blade Seal (Quest 2378 - Sixth Mission: Destroying the Evidence 2)
diff --git a/data/reward/2000.yaml b/data/reward/2000.yaml
@@ -0,0 +1,5 @@
+# Mob 2000 (2000)
+
+rewards:
+- [4031161, 1, 1, 1.0, 1008]
+- [4031162, 1, 1, 1.0, 1008]
diff --git a/data/reward/2040001.yaml b/data/reward/2040001.yaml
@@ -0,0 +1,11 @@
+# Mob 2040001
+
+rewards:
+  - [ 0, 110, 165, 0.600000 ]
+  - [ 2000001, 1, 1, 0.015000 ] # Orange Potion
+  - [ 2000002, 1, 1, 0.015000 ] # White Potion
+  - [ 2000003, 1, 1, 0.010000 ] # Blue Potion
+  - [ 4000021, 1, 1, 0.040000 ] # Leather
+  - [ 4004000, 1, 1, 0.001000 ] # Power Crystal Ore
+  - [ 4010001, 1, 1, 0.002000 ] # Steel Ore
+  - [ 4020001, 1, 1, 0.002000 ] # Amethyst Ore
diff --git a/data/reward/2040002.yaml b/data/reward/2040002.yaml
@@ -0,0 +1,11 @@
+# Mob 2040002
+
+rewards:
+  - [ 0, 115, 172, 0.600000 ]
+  - [ 2000001, 1, 1, 0.015000 ] # Orange Potion
+  - [ 2000002, 1, 1, 0.015000 ] # White Potion
+  - [ 2000003, 1, 1, 0.010000 ] # Blue Potion
+  - [ 4000021, 1, 1, 0.040000 ] # Leather
+  - [ 4004001, 1, 1, 0.001000 ] # Wisdom Crystal Ore
+  - [ 4010001, 1, 1, 0.002000 ] # Steel Ore
+  - [ 4020002, 1, 1, 0.002000 ] # AquaMarine Ore
diff --git a/data/reward/2040003.yaml b/data/reward/2040003.yaml
@@ -0,0 +1,11 @@
+# Mob 2040003
+
+rewards:
+  - [ 0, 118, 177, 0.600000 ]
+  - [ 2000001, 1, 1, 0.015000 ] # Orange Potion
+  - [ 2000002, 1, 1, 0.015000 ] # White Potion
+  - [ 2000003, 1, 1, 0.010000 ] # Blue Potion
+  - [ 4000021, 1, 1, 0.040000 ] # Leather
+  - [ 4004002, 1, 1, 0.001000 ] # DEX Crystal Ore
+  - [ 4010001, 1, 1, 0.002000 ] # Steel Ore
+  - [ 4020003, 1, 1, 0.002000 ] # Emerald Ore
diff --git a/data/reward/2040004.yaml b/data/reward/2040004.yaml
@@ -0,0 +1,11 @@
+# Mob 2040004
+
+rewards:
+  - [ 0, 120, 180, 0.600000 ]
+  - [ 2000001, 1, 1, 0.015000 ] # Orange Potion
+  - [ 2000002, 1, 1, 0.015000 ] # White Potion
+  - [ 2000003, 1, 1, 0.010000 ] # Blue Potion
+  - [ 4000021, 1, 1, 0.040000 ] # Leather
+  - [ 4004003, 1, 1, 0.001000 ] # LUK Crystal Ore
+  - [ 4010001, 1, 1, 0.002000 ] # Steel Ore
+  - [ 4020004, 1, 1, 0.002000 ] # Opal Ore
diff --git a/data/reward/2040005.yaml b/data/reward/2040005.yaml
@@ -0,0 +1,11 @@
+# Mob 2040005
+
+rewards:
+  - [ 0, 125, 187, 0.600000 ]
+  - [ 2000001, 1, 1, 0.015000 ] # Orange Potion
+  - [ 2000002, 1, 1, 0.015000 ] # White Potion
+  - [ 2000003, 1, 1, 0.010000 ] # Blue Potion
+  - [ 4000021, 1, 1, 0.040000 ] # Leather
+  - [ 4004000, 1, 1, 0.001000 ] # Power Crystal Ore
+  - [ 4010001, 1, 1, 0.002000 ] # Steel Ore
+  - [ 4020005, 1, 1, 0.002000 ] # Sapphire Ore
diff --git a/data/reward/2040006.yaml b/data/reward/2040006.yaml
@@ -0,0 +1,11 @@
+# Mob 2040006
+
+rewards:
+  - [ 0, 127, 190, 0.600000 ]
+  - [ 2000001, 1, 1, 0.015000 ] # Orange Potion
+  - [ 2000002, 1, 1, 0.015000 ] # White Potion
+  - [ 2000003, 1, 1, 0.010000 ] # Blue Potion
+  - [ 4000021, 1, 1, 0.040000 ] # Leather
+  - [ 4004001, 1, 1, 0.001000 ] # Wisdom Crystal Ore
+  - [ 4010001, 1, 1, 0.002000 ] # Steel Ore
+  - [ 4020006, 1, 1, 0.002000 ] # Topaz Ore
diff --git a/data/reward/2040007.yaml b/data/reward/2040007.yaml
@@ -0,0 +1,11 @@
+# Mob 2040007
+
+rewards:
+  - [ 0, 130, 195, 0.600000 ]
+  - [ 2000001, 1, 1, 0.015000 ] # Orange Potion
+  - [ 2000002, 1, 1, 0.015000 ] # White Potion
+  - [ 2000003, 1, 1, 0.010000 ] # Blue Potion
+  - [ 4000021, 1, 1, 0.040000 ] # Leather
+  - [ 4004002, 1, 1, 0.001000 ] # DEX Crystal Ore
+  - [ 4010001, 1, 1, 0.002000 ] # Steel Ore
+  - [ 4020007, 1, 1, 0.002000 ] # Diamond Ore
diff --git a/data/reward/2040008.yaml b/data/reward/2040008.yaml
@@ -0,0 +1,11 @@
+# Mob 2040008
+
+rewards:
+  - [ 0, 132, 198, 0.600000 ]
+  - [ 2000001, 1, 1, 0.015000 ] # Orange Potion
+  - [ 2000002, 1, 1, 0.015000 ] # White Potion
+  - [ 2000003, 1, 1, 0.010000 ] # Blue Potion
+  - [ 4000021, 1, 1, 0.040000 ] # Leather
+  - [ 4004003, 1, 1, 0.001000 ] # LUK Crystal Ore
+  - [ 4010001, 1, 1, 0.002000 ] # Steel Ore
+  - [ 4020008, 1, 1, 0.002000 ] # Black Crystal Ore
diff --git a/data/reward/2040009.yaml b/data/reward/2040009.yaml
@@ -0,0 +1,11 @@
+# Mob 2040009
+
+rewards:
+  - [ 0, 135, 202, 0.600000 ]
+  - [ 2000001, 1, 1, 0.015000 ] # Orange Potion
+  - [ 2000002, 1, 1, 0.015000 ] # White Potion
+  - [ 2000003, 1, 1, 0.010000 ] # Blue Potion
+  - [ 4000021, 1, 1, 0.040000 ] # Leather
+  - [ 4004004, 1, 1, 0.001000 ] # Dark Crystal Ore
+  - [ 4010001, 1, 1, 0.002000 ] # Steel Ore
+  - [ 4020001, 1, 1, 0.002000 ] # Amethyst Ore
diff --git a/data/reward/2040010.yaml b/data/reward/2040010.yaml
@@ -0,0 +1,11 @@
+# Mob 2040010
+
+rewards:
+  - [ 0, 138, 207, 0.600000 ]
+  - [ 2000001, 1, 1, 0.015000 ] # Orange Potion
+  - [ 2000002, 1, 1, 0.015000 ] # White Potion
+  - [ 2000003, 1, 1, 0.010000 ] # Blue Potion
+  - [ 4000021, 1, 1, 0.040000 ] # Leather
+  - [ 4004000, 1, 1, 0.001000 ] # Power Crystal Ore
+  - [ 4010001, 1, 1, 0.002000 ] # Steel Ore
+  - [ 4020002, 1, 1, 0.002000 ] # AquaMarine Ore
diff --git a/data/reward/2040011.yaml b/data/reward/2040011.yaml
@@ -0,0 +1,11 @@
+# Mob 2040011
+
+rewards:
+  - [ 0, 140, 210, 0.600000 ]
+  - [ 2000001, 1, 1, 0.015000 ] # Orange Potion
+  - [ 2000002, 1, 1, 0.015000 ] # White Potion
+  - [ 2000003, 1, 1, 0.010000 ] # Blue Potion
+  - [ 4000021, 1, 1, 0.040000 ] # Leather
+  - [ 4004001, 1, 1, 0.001000 ] # Wisdom Crystal Ore
+  - [ 4010001, 1, 1, 0.002000 ] # Steel Ore
+  - [ 4020003, 1, 1, 0.002000 ] # Emerald Ore
diff --git a/data/reward/2040012.yaml b/data/reward/2040012.yaml
@@ -0,0 +1,11 @@
+# Mob 2040012
+
+rewards:
+  - [ 0, 142, 213, 0.600000 ]
+  - [ 2000001, 1, 1, 0.015000 ] # Orange Potion
+  - [ 2000002, 1, 1, 0.015000 ] # White Potion
+  - [ 2000003, 1, 1, 0.010000 ] # Blue Potion
+  - [ 4000021, 1, 1, 0.040000 ] # Leather
+  - [ 4004002, 1, 1, 0.001000 ] # DEX Crystal Ore
+  - [ 4010001, 1, 1, 0.002000 ] # Steel Ore
+  - [ 4020004, 1, 1, 0.002000 ] # Opal Ore
diff --git a/data/reward/2040013.yaml b/data/reward/2040013.yaml
@@ -0,0 +1,11 @@
+# Mob 2040013
+
+rewards:
+  - [ 0, 145, 217, 0.600000 ]
+  - [ 2000001, 1, 1, 0.015000 ] # Orange Potion
+  - [ 2000002, 1, 1, 0.015000 ] # White Potion
+  - [ 2000003, 1, 1, 0.010000 ] # Blue Potion
+  - [ 4000021, 1, 1, 0.040000 ] # Leather
+  - [ 4004003, 1, 1, 0.001000 ] # LUK Crystal Ore
+  - [ 4010001, 1, 1, 0.002000 ] # Steel Ore
+  - [ 4020005, 1, 1, 0.002000 ] # Sapphire Ore
diff --git a/data/reward/2040015.yaml b/data/reward/2040015.yaml
@@ -0,0 +1,11 @@
+# Mob 2040015
+
+rewards:
+  - [ 0, 148, 222, 0.600000 ]
+  - [ 2000001, 1, 1, 0.015000 ] # Orange Potion
+  - [ 2000002, 1, 1, 0.015000 ] # White Potion
+  - [ 2000003, 1, 1, 0.010000 ] # Blue Potion
+  - [ 4000021, 1, 1, 0.040000 ] # Leather
+  - [ 4004004, 1, 1, 0.001000 ] # Dark Crystal Ore
+  - [ 4010001, 1, 1, 0.002000 ] # Steel Ore
+  - [ 4020006, 1, 1, 0.002000 ] # Topaz Ore
diff --git a/data/reward/2040017.yaml b/data/reward/2040017.yaml
@@ -0,0 +1,11 @@
+# Mob 2040017
+
+rewards:
+  - [ 0, 150, 225, 0.600000 ]
+  - [ 2000001, 1, 1, 0.015000 ] # Orange Potion
+  - [ 2000002, 1, 1, 0.015000 ] # White Potion
+  - [ 2000003, 1, 1, 0.010000 ] # Blue Potion
+  - [ 4000021, 1, 1, 0.040000 ] # Leather
+  - [ 4004000, 1, 1, 0.001000 ] # Power Crystal Ore
+  - [ 4010001, 1, 1, 0.002000 ] # Steel Ore
+  - [ 4020007, 1, 1, 0.002000 ] # Diamond Ore
diff --git a/data/reward/2040018.yaml b/data/reward/2040018.yaml
@@ -0,0 +1,11 @@
+# Mob 2040018
+
+rewards:
+  - [ 0, 152, 228, 0.600000 ]
+  - [ 2000001, 1, 1, 0.015000 ] # Orange Potion
+  - [ 2000002, 1, 1, 0.015000 ] # White Potion
+  - [ 2000003, 1, 1, 0.010000 ] # Blue Potion
+  - [ 4000021, 1, 1, 0.040000 ] # Leather
+  - [ 4004001, 1, 1, 0.001000 ] # Wisdom Crystal Ore
+  - [ 4010001, 1, 1, 0.002000 ] # Steel Ore
+  - [ 4020008, 1, 1, 0.002000 ] # Black Crystal Ore
diff --git a/data/reward/2040022.yaml b/data/reward/2040022.yaml
@@ -0,0 +1,11 @@
+# Mob 2040022
+
+rewards:
+  - [ 0, 155, 232, 0.600000 ]
+  - [ 2000001, 1, 1, 0.015000 ] # Orange Potion
+  - [ 2000002, 1, 1, 0.015000 ] # White Potion
+  - [ 2000003, 1, 1, 0.010000 ] # Blue Potion
+  - [ 4000021, 1, 1, 0.040000 ] # Leather
+  - [ 4004002, 1, 1, 0.001000 ] # DEX Crystal Ore
+  - [ 4010001, 1, 1, 0.002000 ] # Steel Ore
+  - [ 4020001, 1, 1, 0.002000 ] # Amethyst Ore
diff --git a/data/reward/2040023.yaml b/data/reward/2040023.yaml
@@ -0,0 +1,11 @@
+# Mob 2040023
+
+rewards:
+  - [ 0, 157, 235, 0.600000 ]
+  - [ 2000001, 1, 1, 0.015000 ] # Orange Potion
+  - [ 2000002, 1, 1, 0.015000 ] # White Potion
+  - [ 2000003, 1, 1, 0.010000 ] # Blue Potion
+  - [ 4000021, 1, 1, 0.040000 ] # Leather
+  - [ 4004003, 1, 1, 0.001000 ] # LUK Crystal Ore
+  - [ 4010001, 1, 1, 0.002000 ] # Steel Ore
+  - [ 4020002, 1, 1, 0.002000 ] # AquaMarine Ore