#  Project Title :

** PROJECT RANDOM THINGS MOD **

This is Project Random Things Mod, which AzzyAzimuth and I, nubxd11, code fun things here.


## Authors and Credits :

1. AzzyAzimuth : Main developer, concepts and logic
2. nubxd11 : Co-Developer, visuals and assets
3. KaiDevrim : Tutorial for the ruby and ruby block
4. SPECIAL THANKS TO THE MINECRAFT FORGE COMMUNITY!!


## Bugs and Reports :

If bugs are found in this mod, please open an issue in the *Issues* section in our project repository in GitHub
web page. Please also include the crash log so that we can help you fix the issue!

*** IMPORTANT *** This might be the final version of this mod, and we might not continue working on this mod. So
feel free to copy and adjust the mod according to your preferences!

##  About This Project :

AzzyAzimuth and I have always wanted to enjoy Minecraft in our own way. We have always been best of the best
friends since we were little. So we started this project with the same intent, to code this mod which includes
the most random things that we love and enjoy. AzzyAzimuth has helped me a lot, so I shall thank him here. And
here we are, presenting to you this mod.


##  Funny Stories :
So AzzyAzimuth and I were in the middle of getting this sapphire visual trying to get the Blockbench model to
work, and it keeps displaying black and magenta textures. So we ran through the registry and the sapphire block
java class before noticing the .json files had a typo, writing 'block' as 'blocks'. We both stared at each other
thinking we are absolute idiots for not noticing.

Another time, we spent 8 hours on the mortar and still couldn't get the grenade to launch out of the mortar.
Eventually after 2 days of work, and we succeeded on the third day. I was at home working with him communicating
via a video call. He saw me jumping up and down celebrating, and said,"This is the first time I've seen you this
happy." We were happy when we were friends, but not as happy as that. He was shocked as hell. Haha!


##  "What if?" :
What if I have infinite skill and time in the world for this project? I would love to make a modded FPS game out
from this. This means that I can make guns like the M4A1, SMG 45, AWM and so on like the ones in Delta Force or PubG.
Oh, cars tanks and fighter jets too! Like the F16 fighter jet, or a bomber plane. We can make objectives to capture
and then if all objectives are captured then you win or all objectives defended then you win. Just like Delta Force
warfare mode. There are many many more that I would like to do, but listing them would make the README too long.


##  Tech Stack :

**Language** : Java
**Framework** : Forge
**Database** : JSON
**Java:** JDK 11 installed and set in your environment variables.
**Code Editor:** IntelliJ IDEA (Recommended), Eclipse, or VS Code.
**Minecraft Version** : 1.15.2 Java Edition


##  Installation :

1. In GitHub (browser version), press the green "code" button.
2. Press download zip.
3. Unzip by right-click the zip file in the file explorer and press extract all.
4. Then paste everything in a folder for good organisation.
5. Press 'open' or 'import project' the files into your code editor
6. Must build Gradle before running the code!!! (This may take a long time for first launch)
7. Run the project using the built-in Forge run configuration or execute 'gradlew runClient' in your terminal!
8. Do read the wiki in GitHub so that you can understand how the added items work!

##  A Small Failed Item... :(

0. Night Vision Goggle Helmet
THIS IS NOT AN ADDED ITEM, HENCE WHY IT'S NUMBER 0!!! It was the earlier prototype of the night vision goggles.
Making an armour item was absolute chaos. That is why we made the goggles only. It was originally supposed to
be a helmet with camouflage colours with the goggles at eye level with night vision goggles features. This was
a big step up from items since the code interpretation system got the helmet texture absolutely screwed up! So
then AzzyAzimuth battled with the texture for a whole afternoon into the midnight without bits of progression.
The functions are there, but the models and textures were absolutely damned. To make things look perfect, we
decided to keep the code but to make every line of code comments.


##  Added items :

1. The Bauxite Block
Ahh yes, the iron(II) oxide, which is the real world version of the iron ore that we find and mine in caves.
These are brown solids, which are then put into fire to make carbon dioxide and iron. We did not include the
extraction logic in this mod since we believed that this block is a starter block. The block is brown in colour
with darker brown pixels on each side of the block. Apologies if nubxd11 has made the block look like smeared poop!
He said, and I quote, "I am not good at visual arts, I have almost failed the subject before, so don't expect much
from me". The world generation code was written later on in the project since we believed that the block logics
can be more complete.

2. The Sapphire Block
A mineral that is extremely hard, and is used for the glass in watches to prevent scratches. This mineral is
just slightly weaker in hardness than diamond (10) in the mohs hardness scale (sapphire's hardness in the mohs
hardness scale is 9, the third-hardest mineral on Earth). For this block, we made the block having a high hardness,
same as the diamond block. Again, this block has a world generation code so that it can replace stone blocks and
appear underground. This block is blue, and has lighter coloured pixels in such to make it look shiny.

3 & 4. The Ruby Block & the Ruby
These blocks are just here for the vibes, but we have given them simple block properties like every other block.
Rubies are shiny and transparent red gemstones that are used for jewellery making. This block's texture is a picture
rather than a solid texture file (.json files) that is made in Blockbench where most of the textures in the mod are
created in. This block is the first block that is made in this mod and AzzyAzimuth prioritised simple and direct
solutions at that time.

5. The Red Lego Block
Remember the times that you have stepped on a Lego block? It must've hurt badly! And yes, we have put this block
into the mod to make things funny. This block is coded to deal half a heart of damage when stepped on, walked on,
jumped on and when landed on. This block is red in colour, and has studs popping out of the top to look like each
block slots on the other.

6 & 7. The Nuclear Bomb Block and the Nuclear Bomb Remote Controller
Ever wanted to see massive destruction? We've got your back! This nuclear bomb block is 5 times the strength of a TNT
block, and can absolutely destroy anything in its way. The fuse is the same as the TNT block, 4 seconds. This yellow
block with nuclear hazard signs which can be detonated with a flint and steel, a flaming arrow, a redstone signal,
and the most obvious in the title, the nuclear bomb remote controller. This controller can pair with a nuclear
bomb on the map, and can detonate the bomb at anywhere in the world!

8. The Stool
To rest or not to rest, that is the question. There is now a choice to sit down in the game! You never have to worry
about constantly standing and being tired in the game! Right-click on the stool to sit, and left shift to dismount.

9 & 10. The Mortar and The Grenade
Need to send things high and far to attack people? This mortar can hit targets up to 100 blocks away! This is a great
tool to use when trying to hit far away enemies. This mortar, rather than launching normal mortar shells, it launches
grenades that detonate on impact. Each shot from the mortar uses one grenade. The grenades that AzzyAzimuth and I
coded when throwing out of hands have a 4-second fuse rather than detonating on impact. AzzyAzimuth and I spent a
long time trying to get the best trajectory for the mortar and the grenade by trialling and erroring. So we do hope
that everyone likes it!

11. The Adrenaline Pill
To be honest, this thing doesn't work in real life, because the hormone will be dissolved when it enters the body. But
hey, this is Minecraft, you can do whatever you like here, so we just added this here, haha! Adrenaline is a hormone
that causes the body to have a "fight or flight" response and also makes the body stronger. For this, this pill has a
strength effect. This pill does not replenish any hunger though. Use at your risks!!

12. The Aerosol Can
Remember the times that a guy has thrown a deodorant bomb into a room to simulate a grenade explotion? Well, that's
one effective way to do so. And the explosion and impact when the can breaks is actually enormous. We have applied
this logic to the mod and this item. This explosion will not cause fire, but the impact is the same as a TNT block.
It still removes blocks, deal damage and also knockback.

13. The Air Blast
Oh we love the Palm-leaf Fan in the Journey To The West. This fan creates strong wind, which made the fire on the
Fiery Mountains to be stronger. Well, we don't have a Fiery Mountain, but we do have our own fan, air blast! No,
it does not make fire stronger, and it does not blow structure away, but this fan has huge knockback! Playing
around with this fan is actually huge fun, when you can see animals being blown to the other side of the river.
It is literally so funny to watch!

14, 15 & 16. The Apple Juice Bottle, the Carrot Juice Bottle and the Melon Juice Bottle
It is weird that Minecraft does not have juice-related items. So we made some juice bottles. The juice bottles are
not supposed to feed the player full, but at least there is a way for food. Don't worry, you won't eat the bottle. The
glass will be put back to the inventory after consuming, so no concerns of glass hurting your throat.

17. The Belt
The strict fathers' weapon, I can feel the pain through the screen. Be more than a meter away from the belt means that
you will be fine. Being whipped by the belt will definitely hurt like hell, so it causes big damage. Mind the keyword,
big, not huge, not massive. There are more crazy weapons waiting with higher damage.

18. The Slipper
Oh no, not the strict Asian mothers' weapon right after... RUN FOR YOUR LIVES!!! AIR RAID!!! This slipper is a
long range weapon, not a short range weapon like the belt. We have made this so that you can throw it. This slipper
doesn't deal as much damage as the belt, because the belt is always worse than the slipper, although asians do have
ways to make it hurt more... Oh well, this slipper is rubber made, we can't make it hurt more.

19. The Suspicious Berry
A sibling of the suspicious series. There is a chance to get bad omen, hero of the village, luck and unluck, each
with 25 per cent chance of each. We forgot to include this in my demo video, so we are going to write about it here.
This berry is colourful, with different colours of the rainbow included in the berry, symbolising the different
choices we get. Sadly, this does not replenish any hunger, and is only a tool to get an effect.

20, 21 & 22. The Candy, the Sugar High Effect and the Coffee Candy
Sweet treats, our favourite. The candy gives people sugar high effects in real life. There are always times that
our friends just eat candy and just do the weirdest things... They just have unlimited power when in sugar high
mode... We implemented the new sugar high effect for the candy, but not the coffe candy. The coffe candy includes
caffeine, so we added speed and haste effects to the coffe candy to simulate the stimulated feeling after consuming
caffeine.

23, 24 & 25. The Char Siu Porkchop, the Honey Glazed Porkchop and the Honey Glazed Chicken
Real meat, doesn't that feel nice. These also taste much better than the normal cooked meat. Char Siu is a really
nice sweet and salty roasted pork, which is Hong Kong people's favourite food. This roasting technique is also used
in western countries, but they use honey to roast the meat. The honey roasted meat is nice too, but not as good as
Chat Siu Porkchop. Anyway, these meat all replenish huge amounts of hunger ad saturation. However, they have no
effects on the player.

26 & 27. The Feather Dust and the Fire Spirit
The dusts that give you effect. Do you guys love the names? Well, we love them at least. Feather Dust, from the name
means that you fall like a feather, so it gives you a slow falling effect. Fire Spirit, also from its name, gives you
fire resistance. These are both effect tools, they do not replenish hunger.

28. The Paracetamol Pill
"I've got a headache, what should I do?" Take a paracetamol pill! These pills relieve your pain issues, but they do
come at a cost. You must rest after eating the paracetamol pill. So this pill gives you the new added fatigue effect.
This fatigue effect will decrease your movement speed by 15%, and your attack speed by 20%. In addition, there is also
mining fatigue along with the two decreases as a package. So remember to rest, not go on a mining trip after eating
this pill!

29 & 30. The Drunk Goggles and the Night Vision Goggles
Want to experience the feeling of being drunk? We've got you! The drunk goggles give you an effect of nausea 2 and
slowness. This is guarenteed to make you walk so wobbly that you look like that you are drunk! Who needs to chug a
beer when you have the drunk goggles. Need to look out for mobs when it's dark? We have night vision goggles just
for you! This night vision goggles can give you unlimited night vision effect when equipped, and your screen goes
green when equipped, like normal night vision goggles.

31. The Ultra Torch
Why is it so dark in here? *click* Wow, it's much brighter now. The ultra torch has maximum light intensity so that
you can see anything in the dark. There is no more worry about mobs even without night vision goggles! This torch
shines in hand, no matter it is in your main hand or offhand, so it is always a good back up plan if you cannot
get the night vision goggles.

32. The Dagger
A small knife that can be put into a pocket. This can deal huge damage with great skill. A stab with the dagger can
be fatal. Moreover, this dagger is much lighter than a sword, therefore, the waving speed is absolutely rapid. Within
a short timelapse, huge amounts of damage can be done!

33. The Mjölnir
Why is there lightning?! Oh, it's Thor's hammer, the Mjölnir! This is a hammer that summons lightning. It would
probably be the first time that you don't need a thunderstorm to get lightning. This Mjölnir doesn't summon
lightning when you interact with blocks. This hammer also deals damage on its own without lightning! The damage with
the lightning damage is immense!

34. The Scoped Crossbow
There is a crossbow that sends exploding TNT blocks out. It is a fun tool to remove blocks, and you don't ever have to
use that pickaxe that removes one block every time. This scoped crossbow can also be used to shoot mobs from far away.
Playing with this crossbow was so fun that AzzyAzimuth and I challenged each other to hit a tree on a mountain 100
blocks away. Men really are simple creatures...

35 & 36. The MANPADS and the MANPADS Ammo
MANPADS, in longer terms, is Man-Portable Air-Defence System. This is essentially a bazooka in Russian terms or an
RPG in American terms. This device locks your target, and then you right-click to shoot. Each shot uses one MANPADS
ammo. MANPADS ammo was originally named rocket ammo since we thought that it might be used in other occasions. Turns
out, we didn't need it in any other items. Also, to make it easier to understand for players, we made it MANPADS
ammo.

37 & 38. The Pistol and the Bullet
Oh yes, the strongest damage dealer of the mod lineup! This pistol can literally one shot every single mob. The
damage dealt with this pistol is 8 hearts, so you can literally kill anything (as long as you are good at
shooting). Each shot has a cooldown of 0.25 seconds and consumes one bullet. The pistol will not break blocks
when equipped. This pistol shoots when left-clicking, and aims when right-clicking. Aiming and shooting animations
do not interfere with each other.

39. The Radar
Lastly, this is the final thing we added to the mod. This radar can detect hostile mods from 16 blocks away, so
it is very sensitive when you're underground and trying to mine things but not get hurt by mobs. This radar is
active when the radar is in your inventory. This means that you csn be surrounded by stone blocks but the message
of "Hostile Mobs Nearby!" will still appear above your inventory bar. How cool is that?

## Recipe Photos :

Adrenaline pill:
<img width="167" height="77" alt="Image" src="https://github.com/user-attachments/assets/780f2f00-f0ca-4d0a-ba0d-8d304a9ba76a" />

Aerosol can:
<img width="170" height="76" alt="Image" src="https://github.com/user-attachments/assets/86c7082c-fe11-4d3c-8501-c698d650e2ab" />

Air blast:
<img width="167" height="81" alt="Image" src="https://github.com/user-attachments/assets/4e53c1d2-1df0-4673-9be3-ef6ec4b56277" />

Apple juice bottle:
<img width="169" height="78" alt="Image" src="https://github.com/user-attachments/assets/3214ade5-5eab-4497-9b91-6113343cd75c" />

Belt:
<img width="167" height="79" alt="Image" src="https://github.com/user-attachments/assets/2607ccc9-1412-40b6-84af-d173f8b8dda2" />

Bullet:
<img width="173" height="78" alt="Image" src="https://github.com/user-attachments/assets/a95380a6-1981-4079-a7b8-29b7c2bd3028" />

Candy:
<img width="170" height="80" alt="Image" src="https://github.com/user-attachments/assets/e2577bf7-fbd4-446f-ba11-52df52e9b615" />

Carrot juice bottle:
<img width="171" height="78" alt="Image" src="https://github.com/user-attachments/assets/9d7b85c8-bef8-4e1b-8485-dc89f694a823" />

Coffee candy:
<img width="172" height="78" alt="Image" src="https://github.com/user-attachments/assets/743cff35-8906-4978-8ff2-f7233575de13" />

Dagger:
<img width="170" height="80" alt="Image" src="https://github.com/user-attachments/assets/23f67345-3c1a-444a-a08d-f0bb56987ef6" />

Drunk goggles:
<img width="165" height="79" alt="Image" src="https://github.com/user-attachments/assets/a82c73bf-1e3e-42bd-813c-164162d1f4e5" />

Feather dust:
<img width="170" height="80" alt="Image" src="https://github.com/user-attachments/assets/962abe07-624e-4b16-8a90-66f0f8176b06" />

Fire spirit:
<img width="171" height="81" alt="Image" src="https://github.com/user-attachments/assets/8937d1f9-23af-454b-bd01-b7ffc67251a6" />

Grenade:
<img width="166" height="79" alt="Image" src="https://github.com/user-attachments/assets/e5d519f1-ae1b-489a-9e81-f389fe7d4ba2" />

Honey Glazed Porkchop:
<img width="340" height="161" alt="Image" src="https://github.com/user-attachments/assets/45958e7a-44e5-4838-b9b8-07b8d64c0d41" />

Honey Glazed Chicken:
<img width="335" height="158" alt="Image" src="https://github.com/user-attachments/assets/67246911-3bae-4773-8651-0cb04c9ecb8a" />

MANPADS:
<img width="169" height="72" alt="Image" src="https://github.com/user-attachments/assets/616de7d9-34b1-486c-b128-0f7509255487" />

MANPADS ammo:
<img width="170" height="82" alt="Image" src="https://github.com/user-attachments/assets/57fd2a7b-00b6-451a-a29e-bdcdf4c2c8d9" />

Melon juice bottle:
<img width="170" height="73" alt="Image" src="https://github.com/user-attachments/assets/4cdd74ba-7a55-46e9-990d-8ea11d620d14" />

Mjölnir:
<img width="337" height="148" alt="Image" src="https://github.com/user-attachments/assets/34cb4166-de57-4348-8ddc-30f1b9b99d4f" />

Mortar:
<img width="335" height="157" alt="Image" src="https://github.com/user-attachments/assets/25ade66c-c731-43f9-9fd6-def95340ebc7" />

Night vision goggles:
<img width="170" height="81" alt="Image" src="https://github.com/user-attachments/assets/b1d116e6-d56f-462f-8cf5-3363789a5668" />

Nuclear bomb:
<img width="332" height="152" alt="Image" src="https://github.com/user-attachments/assets/53c60bd1-5969-41df-af1f-3b4b256e5b47" />

Nuclear bomb remote controller:
<img width="167" height="67" alt="Image" src="https://github.com/user-attachments/assets/effcf7a4-cb84-4d6c-a7ad-b6aae3d95931" />

Paracetamol pill:
<img width="332" height="152" alt="Image" src="https://github.com/user-attachments/assets/bd2f1629-d9d9-4e8b-aa95-d569c6aaa617" />

Pistol:
<img width="167" height="78" alt="Image" src="https://github.com/user-attachments/assets/bdf719f0-9e7b-40a3-bfec-651a8304507e" />

Radar:
<img width="160" height="79" alt="Image" src="https://github.com/user-attachments/assets/97c30ec8-0163-46cd-8a81-ac7fe4c951a1" />

Red Lego block:
<img width="170" height="80" alt="Image" src="https://github.com/user-attachments/assets/36f4a680-fa00-4657-9d22-6bb7e15bf816" />

Scoped crossbow:
<img width="173" height="79" alt="Image" src="https://github.com/user-attachments/assets/ad284c94-1608-4bcc-81f6-df6719a446c8" />

Slipper:
<img width="170" height="80" alt="Image" src="https://github.com/user-attachments/assets/5506fae9-78cc-4159-958d-d4c8869dfabd" />

Stool:
<img width="333" height="158" alt="Image" src="https://github.com/user-attachments/assets/3ce9ec4f-9dd0-424a-9386-75cab6ba07c6" />
<img width="336" height="158" alt="Image" src="https://github.com/user-attachments/assets/a55e74c9-5219-4952-8255-67160c144182" />
<img width="330" height="161" alt="Image" src="https://github.com/user-attachments/assets/8dcb5785-9054-45c6-a2f1-d88ea0f86ce7" />
*** KEY: STOOL CAN BE MADE WITH ANY SLABS!!! ***

Ultra torch:
<img width="328" height="157" alt="Image" src="https://github.com/user-attachments/assets/36814faa-72fc-4609-8f0e-0ca6a93641f8" />


## Licence and Copyright :

Copyright (c) 2026 AzzyAzimuth and nubxd11. All rights reserved.
Distribution of any portions of code or raw assets without explicit written permission is strictly prohibited.
In case of distribution, all developers must be included in the credits.