A modular, extensible and easy to use Java game and application engine.
Find a file
JeremyStarTM 081ac106f4
DependencyResolver rewrite, likely broken
This seems to work, but it probably has lots of bugs as I can't really test it efficiently. Need to write unit tests for this, aw man...

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
So we back in the mine
Got our pickaxe swinging from side to side
Side-side to side
This task, a grueling one
Hope to find some diamonds tonight, night, night
Diamonds tonight

Heads up
You hear a sound, turn around and look up
Total shock fills your body
Oh, no, it's you again
I can never forget those eyes, eyes, eyes
Eyes-eye-eyes

'Cause, baby, tonight
The creeper's tryna steal all our stuff again
'Cause, baby, tonight
You grab your pick, shoval and bolt again (Bolt again-gain)
And run, run until it's done, done
Until the sun comes up in the morn'
'Cause, baby, tonight
The creeper's tryna steal all our stuff again (Stuff again-gain)

Just when you think you're safe
Overhear some hissing from right behind
Right-right behind
THat's a nice life you have
Shame it's gotta end at this time, time, time
Time-time-time-time

Then your health bar drops and you could use a one-up
Get inside, don't be tardy
So, now you're stuck in there
Half a heart is left, but don't die, die, die
Die-die-die

'Cause, baby, tonight
The creeper's tryna steal all our stuff again
'Cause, baby, tonight
You grab your pick, shovel and bolt again (Bolt again-gain)

(Creepers, you're mine, haha)
Dig up diamonds and craft those diamonds
And make some armor, get it, baby
Go and forge that like you so MLG pro
The sword's made of diamonds, so come at me, bro, huh
Training in your room under the torchlight
Hone that form to get you ready for the big fight
Every single day and the whole night
Creeper's out prowlin', hoo, alright
Look at me, look at you
Take my revenge, that's what I'm gonna do
I'm a warrior, baby, what else is new?
And my blade's gonna tear through you, bring it

'Cause, baby, tonight
The creeper's tryna steal all our stuff again
(Gather your stuff, yeah, let's take back the world)
Yeah, baby, tonight (Haha)
Grab your sword, armor and go (It's on)
Take your revenge (Woo), oh-oh, oh-oh
So fight, fight, like it's the last, last night
Of your life, life, show them your bite (Woo)

'Cause, baby, tonight
The creeper's tryna steal all our stuff again
'Cause, baby, tonight
You grab your pick, shovel and bolt again (Bolt again-gain, woo)
And run, run until it's done, done
Until the sun comes up in the morn'
'Cause, baby, tonight (Come on, swing your sword up high)
The creeper's tryna steal all our stuff again (Come on, jab your sword down low)
(Woo)
2024-08-17 21:57:10 +02:00
.idea Sort and add new tasks 2024-07-11 04:15:37 +02:00
ansi Update DependencyVector 2024-08-17 13:26:12 +02:00
base DependencyResolver rewrite, likely broken 2024-08-17 21:57:10 +02:00
dist Add dist/ directory 2024-06-16 13:34:56 +02:00
docs MASSIVE CODE CHANGE 2024-07-31 03:53:44 +02:00
gradle/wrapper Update to Gradle 8.9 2024-08-01 02:04:54 +02:00
graphics Update DependencyVector 2024-08-17 13:26:12 +02:00
slf4j-compat Update DependencyVector 2024-08-17 13:26:12 +02:00
src/main/javadoc Update overview.html & add ANSI theme.css symlink 2024-08-01 03:01:37 +02:00
testapp Finalize ListConverter 2024-08-12 20:51:37 +02:00
.gitignore Add 'run/' entry to gitignore 2024-07-16 14:53:17 +02:00
build.gradle Remove "v" from version because of Maven versions 2024-08-01 02:02:19 +02:00
COPYING Add classpath exception 2024-07-11 23:29:23 +02:00
gradle.properties Update version identifier to v1-alpha4 2024-08-17 14:01:01 +02:00
gradlew Update to Gradle 8.9 2024-08-01 02:04:54 +02:00
gradlew.bat Update to Gradle 8.9 2024-08-01 02:04:54 +02:00
LICENSE Add classpath exception 2024-07-11 23:29:23 +02:00
README.md Update README 2024-07-29 22:45:07 +02:00
settings.gradle Move ANSI-related stuff into 'ansi' module 2024-07-29 21:34:10 +02:00

StarOpenSource Engine

The StarOpenSource Engine (or sos!engine for short) is a modular, extensible and easy to use Java game and application engine.

WARNING

The StarOpenSource Engine is under heavy development and is extremely unstable. Code will break often, prepare for potential major refactors when trying the engine out.

Index

About

... the engine

The StarOpenSource Engine is a modular and extensible framework for building applications and games written in the Java programming language. The engine consists of various subsystems, each separate and responsible for only a few closely-related things.
Not only that. The engine also features various useful classes, interfaces and methods making development fun and simpler, while being lightweight.

... the repository

The sos!engine repository is a monorepo, consisting of the core engine, multiple official subsystems and their documentation.

Priorities

These are in no particular order.

  • configurable
  • do one thing and do it well (subsystems concept)
  • fast
  • few runtime dependencies (note: we will cut down on some of them during development)
  • modular & extensible
  • small & lightweight

Documentation

You can view the engine documentation at engine.staropensource.de. It provides information, guides and tutorials about the core engine and subsystems. If you want the API reference, you can visit the Javadoc for the engine and it's subsystems.

Contributing

Requirements

You need the following things to be able to contribute code to the StarOpenSource Engine:

  • knowledge of Java
  • knowledge about the internals of engine

What IDE to use?

We recommend and are using IntelliJ IDEA Community Edition for development because it is flexible, extendable, customizable, provides good completions and error detection. It's also open source.

Code style

We recommend looking at existing classes and code for a good understanding on how we'd like code to be written. Here's a quick rundown on the most important things:

  • Document EVERYTHING. Every single class, field and method, even if private.
  • Make comments about your code, unless it's extremly simple and easy to understand.
  • Make sure to add and update @since in javadoc comments (update if the javadoc changes a good amount).
  • Keep stuff simple, no need to elaborate what a logger is. Though remember to not make it too simple.
  • Make sure every field and method has a newline to seperate it.
  • Files must end with a newline or cats might get angry.
  • Use your brain.

Pull request guidelines

Before creating a pull request, make sure you've:

  • created tests for the functionality you've added, changed or removed (if applicable),
  • tested your changes,
  • made sure that everything works,
  • is compatible with other code in the monorepo, and
  • is compatible with other applications. If not, tell us in your pull request description.

Making your first contribution

TODO