Skip to content

Commit

Permalink
Improved README.md, split off task list into separate file (TASKS.md)
Browse files Browse the repository at this point in the history
  • Loading branch information
Marukyu committed May 6, 2016
1 parent 68e96d9 commit 9e604c0
Show file tree
Hide file tree
Showing 2 changed files with 104 additions and 25 deletions.
104 changes: 79 additions & 25 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,36 +1,90 @@
# NecroEdit

External level editor for Crypt of the NecroDancer.

**[Download the latest release here!](https://github.com/Marukyu/NecroEdit/releases)**

Requires a copy of Crypt of the NecroDancer.
Please see the section *Installation* if you are having issues running NecroEdit.

## Features

### Done
* Level rendering
* Dungeon loading
* Dungeon saving
* Basic brush tools (place/erase objects and tiles)
* Level management (select, add, remove, arrange levels)
* Level properties (music, boss, player spawn point)

### In progress
* Better object placement (object stacking, removing topmost object only, etc.)
* Object properties when placing (position, type, enemy beat delay, chest content, etc.)

### TODO
* *Fix save action (currently aliased to "save as")*
* Selection tool
* Picking for brush tools (select tile hovered by mouse cursor)
* More brush shapes (line, rectangle)
* Customizable keyboard and mouse controls
* Undo/Redo

### Future ideas
* Extra tools for specific tasks (e.g. bouncetrap chains)
* "Test level" button (requires API from NecroDancer)
* Networking (multi-user realtime editing)
* Mouse controls
* Graphical tile and object selection
* Level arrangement and duplication
* Better object placement
* Multiple objects can be stacked on the same tile
* Movable player spawn point
* Additional tiles and objects
* Tiles and objects that are normally inaccessible in the editor can be placed
* Examples: Lava tiles, Golden Lute, Ninja Mask
* Additional settings for objects
* Examples: Lord enemies, single choice items, hidden chests

## Controls

Choose a tool from the toolbar at the top of the editor window to get started.

* **Left click** to place objects or tiles.
* **Right click** to erase objects or tiles.
* **Middle click** to move the view around the level.
* Use the **mouse wheel** to zoom in or out.

## Installation

**NecroEdit requires a copy of Crypt of the NecroDancer to be installed on your computer.**

### Windows

**[Download the latest release here!](https://github.com/Marukyu/NecroEdit/releases)**

Extract the Windows release archive to your desired installation folder and open `NecroEdit.exe`.

If `vcruntime140.dll` or any other DLL file is missing, install
[Visual C++ 2015 Redistributable](https://www.microsoft.com/en-us/download/details.aspx?id=48145) restart your computer
and try running NecroEdit again.

If the DLL problem persists, please report the bug by opening an issue on this GitHub repository.

### Linux

**[Download the latest release here!](https://github.com/Marukyu/NecroEdit/releases)**

[SFML 2.3](http://sfml-dev.org), [Boost](http://boost.org) System and Boost Filesystem are required. You can install
them using your distribution's package manager or from the repsective project websites.

Extract the Linux release archive to your desired installation path and run `./NecroEdit` in the installation path.

Only 64-bit Linux binaries are provided. To use NecroEdit on 32-bit Linux, a build from source is required.

### Building from source

Clone this repository using Git and use [CMake](https://cmake.org) to build NecroEdit from source.

```sh
git clone https://github.com/Marukyu/NecroEdit.git
cd NecroEdit
cmake .
make
```

Development versions of [SFML 2.3](http://sfml-dev.org) (and its dependencies), [Boost](http://boost.org) System and
Boost Filesystem must be installed.

A C++11 compliant compiler such as GCC 4.8 or Visual Studio 2015 is required to build NecroEdit.

## Screenshots

[Editing level (zoomed in)](http://i.imgur.com/eN00kTj.png)
[Editing level (zoomed out)](http://i.imgur.com/hej7AFZ.png)
[Item placement](http://i.imgur.com/mBacWM8.png)

(Game content in screenshots from Crypt of the NecroDancer; Copyright Brace Yourself Games)

## Contributors

* [Marukyu](https://github.com/Marukyu) (main development of NecroEdit)
* [Alexis Martin](https://github.com/alexismartin) (OS X compatibility)
* [RedMser](https://github.com/RedMser) (fixed a typo in the help message)

## License (MIT License)

Expand Down
25 changes: 25 additions & 0 deletions TASKS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# NecroEdit task list

### Done
* Level rendering
* Dungeon loading
* Dungeon saving
* Basic brush tools (place/erase objects and tiles)
* Level management (select, add, remove, arrange levels)
* Level properties (music, boss, player spawn point)
* Better object placement (object stacking, removing topmost object only, etc.)
* Object properties when placing (position, type, enemy beat delay, chest content, etc.)

### TODO
* *Fix save action (currently aliased to "save as")*
* *Remember game directory choice*
* Selection tool
* Picking for brush tools (select tile hovered by mouse cursor)
* More brush shapes (line, rectangle)
* Customizable keyboard and mouse controls
* Undo/Redo

### Future ideas
* Extra tools for specific tasks (e.g. bouncetrap chains)
* "Test level" button (requires API from NecroDancer)
* Networking (multi-user realtime editing)

0 comments on commit 9e604c0

Please sign in to comment.