budgiepanic/connect3d

Simple 4 in a row game

Connect3D

Connect3D is a simple 4 in a row game. The objective is to make four in a row with your pieces, while preventing other players from doing the same. Connect3D offers 2 - 4 player games and the ability to set the size of the board.

It follows a traditional Model View Controller architecture. Connect3D has three different views.

view	description
Text	Displays the game using the console, accepts text based input.
Software	Displays the game using Java Swing. Uses mouse based input.
Hardware	Displays the game using OpenGL. Uses mouse based input.

How to run

I currently do not know how to package Connect3D's dependencies into a runnable jar file.

As such this is how you can set up an Eclipse project to run Connect3D.

1. First clone the source files into an Eclipse project.
2. Connect3D uses LWJGL v3.3.0 to access OpenGL. The download page for lwjgl is here the Minimal OpenGL preset should be sufficient. Ensure the JOML Addon is selected (JOML version 1.10.3). Use the ZIP Bundle mode. Select your platform in the Natives section.
3. This excellent resource explains how to configure Eclipse to use LWJGL.
4. When Eclipse has been configured to use LWJGL you can run the Main method from Connect3DMain package.

Game controls

To place pieces when using the Software renderer, click in the grid that is drawn to the screen. Hovering the mouse over the grid will show you where the piece will be placed. Use the right mouse button to pan around the board.

When using the Hardware renderer, move the mouse to the column you want to place a piece in. The right mouse button can be dragged to pan around the board. The backspace key toggles the debug view that shows possible piece placements. Scroll up or down to zoom in and out.

Acknowledgements

• The sky box texture is here
• I made extensive use of this book while writing Connect3D
• This resource was also useful for learning the basics of OpenGL
• Some models from lwjglbook were used
• I made the sphere model using blender.

connect3d's Issues

Create sphere mesh

Dynamically resize sphere's based on their Z depth in SoftwareRenderer

Spheres are currently drawn at a fixed size, instead of being proportional to their distance from the camera

HW renderer doesn't display colors correctly after light was added.

Add LWJGL to build and create a window with it

Create swing window to display the game

create board mesh elements

The board mesh will be comprised of cylinders and a base cube

Game shows user where their next piece will be placed

By moving the mouse around the window, the user selects where they want their next piece to be placed.
Before placing a piece, the game should show where it would be placed by rendering an extra piece where it would be placed.

Game config allows board dimension specification

Allow players to choose between classic [444] board and [555] + [666]

convert grid to drawable component

the input grid is currently hard coded into the swing renderer.

update readme

Add how to run instructions
Add licensee
Add sources/citations
Add screenshots

Add mouse input handling to HW renderer

Moving mouse w/ RMB+ should move the camera.

LMB releases should use scene ray casting to find a AABB to choose the input back to the contorller

Implement drawString in HW renderer

Hardware renderer crashes in Main class

In Main class, program crashes when trying to initialize Hardware renderer with the following exception:

Exception in thread "main" java.lang.NoClassDefFoundError: org/lwjgl/Version
at connect3DRender.HardwareRenderer.initialize(HardwareRenderer.java:83)
at connect3DGame.Game.(Game.java:55)
at connect3DMain.Main.main(Main.java:57)
Caused by: java.lang.ClassNotFoundException: org.lwjgl.Version
at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:583)
at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:178)
at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:521)
... 3 more

The exact same code works absolutely fine when the main method is moved to a different file, which makes this a very confusing error indeed.

Convert to Maven and/or Gradle project.

LWJGL requires maven/gradle to work.

Replace AABB offset constants with calculated values

The constant offset values in the SelectionManager for AABBs are only valid for a 444 board.
Replace these offsets with calculates values that take the board size into account.

Add Hardware renderer to game config options

Fix Text rendering

TOP BACK and RIGHT do not display the game correctly.
However, FRONT and LEFT do display correctly.

Software renderer implements drawSphereAt() Graphics interface method

Add post-game drawing of the winning 4 in a row pieces

Currently the game exits immediately when someone wins.
It should wait and allow the players to see the winning combination before exiting.

placePieceAt method doesn't follow its contract

If an (x,z) column is full, the method should return false (cannot place here). instead it throws a runtime exception.

Mouse panning changes view of the board

Create swing dialog element before the game starts

renderer implements setActiveColor() method of Graphics interface

Add 'play again' option

After the game has completed, prompt the player if they want to play again

Game config allows selection of number of players

Game configuration should allow selection of anywhere between 2 and 4 players

Respond to user input on the window

Add mouse listener to respond to user input

Add rotation velocity to SwingRenderer

Fix the sudden jumps when panning

Renderer communicates user events to the game

Program does not fully exit when run from jar + command line

When using the SwingRenderer, the program doesn't fully exit after someone wins.
The JFrame window disappears but the command line is not released back to the OS

refactor event handling code into the controller module, out of the view module

Fix draw requests comparison method

Add mouse clicks to placement mapping

This will be accomplished by using axis aligned bounding boxes where spheres could be placed.
A ray will be cast from the camera, if the ray intersects with a AABB then a sphere will be placed there.
idea used from this book

Rotate input grid when user pans

This feature would be cool, but converting screen space mouse click coordinates back into (x,z) board coordinates will probably be a pain.

draw models that are created by draw requests in HW renderer

on redraw, HW renderer should collect each components draw request.
A new model can be created for each request.

Configuration dialog changes the game renderer

Users should be able to choose between text renderer OR Swing renderer