Skip to content

Commit

Permalink
Updated readme
Browse files Browse the repository at this point in the history
  • Loading branch information
thmsndk committed Aug 30, 2019
1 parent 6eedf41 commit 5c84c7f
Show file tree
Hide file tree
Showing 3 changed files with 14 additions and 9 deletions.
23 changes: 14 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,13 @@
# Screeps3D
A 3D client for the MMORTS Screeps.com
![roomview](readme-images/roomview.png?raw=true "A base on shard2 showing some models")

## Goal
To build a 3D client for Screeps.
![roomview](readme-images/mapoverview.png?raw=true "A base on shard2 showing some models")

## Progress
I think it has a fairly solid foundation so that if anyone wants to contribute to it, it is at a good point. There is a websocket/http client that could be fleshed out more but has all the basic functionality. There is a solid system for rendering rooms/objects. At the moment the project is organized into two systems:
It has a fairly solid foundation so that if anyone wants to contribute to it, it is at a good point. There is a websocket/http client that could be fleshed out more but has all the basic functionality. There is a solid system for rendering rooms/objects. At the moment the project is organized into two systems:

* ScreepsAPI - HTTP/Websocket client for communicating with the server
* Screeps3D - Login, WorldView, RoomView, etc.
Expand All @@ -15,16 +17,19 @@ It would be ideal to keep these two separate, so that the ScreepsAPI can be expo
Here are the major areas that we would like to tackle next:
* ~Get it working with private servers~
* Gameplay options like hotkeys, camera controls, console colors, etc.
* Finish model set for room objects (PowerBanks #23, Portals #19 ... Others?)
* Finish model set for room objects (Extractors)
* ~Rendering roads~
* ~Rendering creeps (new model with player icon downloaded and assigned as texture)~
* Rendering creep, tower, link, etc. actions (particle systems are an excellent way to make these visually appealing)
* Creep Say (I'm imagining a floating text that appears above their heads and drifts up to eventually disappear)
* ~Creep Say (I'm imagining a floating text that appears above their heads and drifts up to eventually disappear)~
* ~Figure out the best way to subscribe/unsubscribe from rooms, fog of war, etc.~
* Visualize nukes flying from source to target room (#58)


## Installation
Download a release from the [release page](https://github.com/thmsndk/Screeps3D/releases)

## Contributing
The Project is built using Unity and C# so the following software is required to run it.

### Software Requirements
Expand All @@ -37,7 +42,7 @@ The Project is built using Unity and C# so the following software is required to
After installation you can open the project in unity, and in the asset menu you can "Open C# Project" to open visual studio
* The C# Solution is constructed every time you open the project with Unity.

## Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. If there is an existing issue you would like to tackle, please mention that in the issue to allow others to collab with you :)


Expand All @@ -48,13 +53,13 @@ Things thmsn came up with initially while streaming botarena
* Crumble walls based on hitpoints
* Render alliances
* Render your "friends" in another color than red
* Make resource/material nodes larger / smaller based on resource amount available
* ~Make resource/material nodes larger / smaller based on resource amount available~
* ~color code material nodes based on the type of material~
* minimap

### stuff found when rendering BotArena
* can we implement a spectator mode? #39
* yes xD, currently shuffles random rooms with pvp if you toffle PVP Spectate on
* yes xD, currently shuffles random rooms with pvp if you toggle PVP Spectate on
* ideas
* follow a creep? perhaps random?
* different camera angels
Expand All @@ -63,8 +68,8 @@ Things thmsn came up with initially while streaming botarena
* selecting creeps and having roads selected sucks

#### bugs
* creeps not despawning
* tombstones not showing
* ~creeps not despawning~
* ~tombstones not showing~
* ~dropped energy not rendered #36~
* attacks are rendered too far (blue beam)
* room update / connection is lost, and rooms looses all data
Expand All @@ -79,7 +84,7 @@ recieved null data from server
(Filename: C:\buildslave\unity\build\Runtime/Export/Debug.bindings.h Line: 45)
```
* http error stays center of screen (Locked)
* Creeps remain dorment after their TTL becomes negative
* ~Creeps remain dorment after their TTL becomes negative~
* CreepView _body.material.mainTexture = _creep.Owner.Badge; Owner is null


Expand Down
Binary file added readme-images/mapoverview.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added readme-images/roomview.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 5c84c7f

Please sign in to comment.