Built with the tools and technologies: Java, Swing, OOP, and game asset management.

---

Table of Contents

• Overview
• Features
• Project Structure
  • Project Index
• Getting Started
  • Prerequisites
  • Installation
  • Usage
  • Testing
• Roadmap
• Contributing
• License
• Acknowledgments
• Credits

---

Overview

Adventure-Jones-4 is a retro-inspired 2D adventure game where you explore dungeons, solve puzzles, and battle monsters using classic weapons and abilities. The goal: collect all ancient artifacts and uncover the final secret of the Jones legacy.

A homage to classic pixel art RPGs with a modern codebase built in Java.

---

Features

• 🎮 Top-down 2D gameplay with grid-based tile interaction
• 🧠 AI pathfinding for monster and NPC movement
• 🔊 Original sound effects and background music
• 🗺️ Multi-map exploration system
• 💬 NPC dialog interactions
• 🧰 Configurable settings via config.txt
• ⚔️ Inventory: swords, whips, bows, medkits, and artifacts
• 🧟 Unique enemies: Mecha, Tyanak, Dwarf, Death, and more
• 🔥 Destructible environment tiles: bushes, barrels, etc.

---

Project Structure

📁 Adventure-Jones-4/
│
├── 📁 src/
│ ├── 📁 AI/ # Find path, path positioning
│ ├── 📁 entity/ # Entity, side characters, player, projectile
│ ├── 📁 main/ # Main, ui, bg, eventhandler, collision logic, etc
│ ├── 📁 monster/ # Boss, monsters, enemies
│ ├── 📁 object/ # Weapons, ammo, armor, artifact
│ ├── 📁 tile/ # Map, Tile, TileManager
│ └── 📁 tile_interactive/ # InteractiveTile, Barrels, Bushes
│
├── 📁 res/
│ ├── 📁 BG/ # BG pictures
│ ├── 📁 font/ # Fonts kiddy, river adventure, wooden log
│ ├── 📁 maps/ # Maps, final
│ ├── 📁 monster/ # Boss, monsters, enemies
│ ├── 📁 npc/ # Npc, oldman sprites
│ ├── 📁 objects/ # Object, objects sprites
│ └── 📁 player/ # MainPlayer, player sprites
│ ├── 📁 projectiles/ # Projectiles, arrows, bullets, flame, Arm
│ ├── 📁 Sound/ # Sound, bg music, sound fx
│ └── 📁 tile_interactive/ # InteractiveTile, Barrels, Bushes
│ └── 📁 tiles/ # Map tiles. dessert, forest, grass, etc
├── 📁 bin/ # Compiled class files
├── 📁 assets/ # banner
├── .classpath
├── .project
├── config.txt
├── LICENSE
├── README.md
└── .gitignore

---

Getting Started

Prerequisites

• Java 17+
• Git (for cloning)
• IDE (e.g., IntelliJ, Eclipse) or use javac in terminal

---

Installation

git clone https://github.com/Roland-Front-Back/Adventure-Jones-4.git
cd Adventure-Jones-4

---

Usage

Compile and run the game using your IDE or via terminal:

javac -d bin src/\*_/_.java
java -cp bin main.Main

You can modify config.txt to tweak game behavior.

---

Testing

Manual testing is recommended. Automated unit tests (optional) can be added using JUnit if desired.

---

Roadmap

• Add save/load game functionality

• Implement boss attack phases

• Add controller support

• Create more unique maps and puzzles

• Refactor AI for better pathfinding performance

---

Contributing

Contributions are welcome! To contribute:

1. Fork the repo

2. Create a feature branch: git checkout -b feature/my-feature

3. Commit your changes: git commit -m 'Add some feature'

4. Push to the branch: git push origin feature/my-feature

5. Open a Pull Request

6. Please follow consistent code style and include brief summaries for major changes.

---

License

• Distributed under the MIT License.

• See LICENSE for more information.

---

Acknowledgments

• freesound.org for open sound effects

• dafont.com for custom pixel fonts

• Inspiration from The Legend of Zelda, Indiana Jones, and other classic action-adventure games

• Java/Swing documentation for GUI components and event handling

---

Credits

• Programming: Computer Science Students - Group 4

• Concept & Design: Retro game inspirations

• Music: Custom SFX or royalty-free music

• Engine: Java + JavaFX

---

Back to top