Skip to content

Activerse is a Java Graphics Engine with its intended purpose for simplifying the game making experience in Java.

License

Notifications You must be signed in to change notification settings

knivier/Activerse

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Activerse

Activerse is a Java Game/Simulation/Physics Engine designed to simplify the game-making experience for 2D games. With Activerse, you have access to basic yet powerful methods that allow you to create your game from the ground up. The possibilities are endless—design and develop games that match your vision.

🚀 What is Activerse?

Activerse is built to empower developers of all skill levels to create 2D games and simulations. From basic physics simulations to fully interactive games, Activerse provides the foundation, and it's up to you to build the rest. The engine is regularly updated with new features and improvements, ensuring you have the tools needed to bring your ideas to life.

🔧 Installation

To start using Activerse, follow these steps:

  1. Download the Latest Version: Visit the Activerse GitHub Releases page and download the source code files from the latest version or the version that best suits your needs.

  2. Set Up Your Project:

    • Extract the downloaded files to your desired project directory.
    • Open the project in your favorite Java IDE (such as IntelliJ IDEA, Eclipse, or VS Code).
  3. Build and Run:

    • Compile the source code within your IDE.
    • Run the engine by executing Main.java.
    • Ensure all debugging modes are turned off (this occurs by default).
  4. Start Building Your Game:

    • Use the provided classes and methods in Activerse to begin developing your game.
    • Customize and expand upon the engine to fit your project requirements.

📚 Getting Started

Reading this file is just the beginning! For more detailed guidance, examples, and documentation, explore the following resources:

  • Activerse GitHub Wiki: Contains comprehensive tutorials, code examples, and a deep dive into all engine functionalities.
  • Official Activerse Website: Visit the website for additional information, updates, and community support.
  • v1.1.2 Profile Research: Contains the profiling and research information of v1.1.2 with provided explanations and evidence.
  • Activerse Examplers: Example games created by the Activerse team usually meant to give you inspiration, show you how the game works, or provide testing to a new version.

⚠️ WARNING
Always use the latest version of Activerse to prevent bugs and avoid compatibility issues. Running outdated versions may result in unexpected behavior or crashes.

💡 IMPORTANT
When starting the engine, always run Main.java and ensure all debugging modes are initialized to off.

📝 License

Activerse © 2024 by Knivier / Agniva is licensed under CC BY-NC-SA 4.0. Well, what does this mean for you?

  • Attribution: You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
  • NonCommercial: You may not use the material for commercial purposes.
  • ShareAlike: If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.
  • No additional restrictions: You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.
  • Disclaimer of Warranties and Limitation of Liability: The material is provided "as-is" without warranties of any kind, and the licensor is not liable for any damages arising from its use.

Error handling

As of v1.3.1, Activerse uses the ACESH System or "Activerse Concurrent Error Handling System". This is a simple and native error reporting interface that utilizes Java's own stack trace along with error codes; should you encounter broken code (or a developer extending the engine), they will know where the error occurred in greater detail.

This system is always improving. Activerse developers are not responsible for broken or malicious code within their product.

File name extensions:

  • 1A - Activerse.java
  • 2A - ActiverseImage.java
  • 3A - ActiverseMouseInfo.java
  • 4A - ActiverseSound.ava
  • 5A - Actor.Java
  • 6A - CollisionnManager.java
  • 7A - GameLoop.Java
  • 8A - KeyBoardInfo.java
  • 9A - MemoryTracker.Java
  • 10A - World.Java
  • PROP.IN.OUT.IO - Activerse.properties error; major screwup by developers

Keywords that may be helpful

  • IO - A central breakdown; this is typically a result of multiple errors that are being caught by ACESH that cause an IO error
  • IN - An input breakdown
  • OUT - An output breakdown
  • LN - Error line reporting
  • DEV - Contact Dev's; this is not a good error
  • CONNTO - A connecting line of code that connects class to class that may cause errors in each

Happy coding, and enjoy bringing your creations to life with Activerse!