https://github.com/rptools/maptool
Virtual Tabletop for playing roleplaying games with remote players or face to face.
https://github.com/rptools/maptool
game hacktoberfest java maptool role-playing roleplaying roleplaying-game roleplaying-games rpg tabletop virtual-tabletop vtt
Last synced: about 16 hours ago
JSON representation
Virtual Tabletop for playing roleplaying games with remote players or face to face.
- Host: GitHub
- URL: https://github.com/rptools/maptool
- Owner: RPTools
- License: agpl-3.0
- Created: 2014-10-21T12:26:48.000Z (over 11 years ago)
- Default Branch: develop
- Last Pushed: 2026-01-23T03:48:30.000Z (4 days ago)
- Last Synced: 2026-01-23T21:37:04.981Z (3 days ago)
- Topics: game, hacktoberfest, java, maptool, role-playing, roleplaying, roleplaying-game, roleplaying-games, rpg, tabletop, virtual-tabletop, vtt
- Language: Java
- Homepage: http://rptools.net
- Size: 232 MB
- Stars: 882
- Watchers: 34
- Forks: 274
- Open Issues: 904
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://crowdin.com/project/maptool)
)
)
[](discord.gg/dZy7HeYYVY)
# MapTool 
Welcome to the MapTool repository! This is the official repository for the MapTool Virtual Tabletop
## So what is MapTool?
MapTool is intended for use in supporting table-top role playing games, such as D&D, PathFinder,
GURPS, Call of Cthulhu, Star Wars, Shadowrun, and many others. It is a mature and full-featured
Virtual
Tabletop (VTT) application that allows users to create, manage, and play their favorite pen and
paper
either in person or remotely.
Included are not only powerful tools for the creation of detailed maps, but also a chat function,
detailed token management (allowing you to track properties of the units placed on the map and
display health and status information), and an initiative tracker. Functions not being used can be
hidden out of sight. These features enable your computer screen to function as a virtual table-top,
fulfilling the role of battlemats and dry-erase markers and providing for infinitely scrollable maps
and the ability to use a large-screen TV or video projector. It is _game system agnostic_, meaning
that while MapTool has special support for some game systems (like hexes for GURPS or square
templates for D&D 4E) there is no requirement for you to use these features.
The best part is all this isn't limited to a single PC. You can utilize the integrated server
function to connect to players wherever there's an Internet connection. Miss your buddy in
Singapore? Not a problem. Roll up that character, and then your sleeves.
And we don't stop there! Not content with just emulating the tabletop, we seek to improve upon the
tabletop experience. This, truly, is where MapTool shines. A set of "topology" and vision features
enable the GM to limit the view of his players, revealing the map as they explore it. Walls and
other objects can prevent players from seeing what lies behind them. Darkness can be made to fall,
blinding players who lack a light. Lights can be set on objects or on tokens that illuminate however
much of the map you wish. If the GM wishes, s/he can limit the view of players to what their
specific token sees, adding a whole new level to the experience of splitting up the party. Woe be to
the character who can't see around the corner of a wall but steps out into the view of the enemy!
## Version Numbers
MapTool follows [Semantic Versioning](https://semver.org/) for version numbering.
Development builds contain the latest features and improvements, while stable releases focus on
reliability and bug fixes. Critical bug fixes and security updates are backported to both stable and
development branches.
## For Users
MapTool is available for Windows, Mac OS X, and Linux.
You can download the latest stable release
from
the following locations
* [MapTool website](https://www.rptools.net/toolbox/download-rptools-products/#/).
* [GitHub: Latest Stable releases](https://github.com/RPTools/maptool/releases/latest).
* [GitHub: All Non-Pre-Releases](https://github.com/RPTools/maptool/releases?q=prerelease%3Afalse&expanded=false).
* [GitHub: Pre-Releases](https://github.com/RPTools/maptool/releases?q=prerelease%3Atrue&expanded=false).
There are several tutorials on the [MapTool wiki](https://wiki.rptools.info/index.php/Main_Page).
on
getting started using MapTool.
The MapTool installers for each platform are self contained and include everthing needed to run
MapTool.
## For Developers
See the [CONTRIBUTING.md](CONTRIBUTING.md) file for information on setting up your development
environment and contributing to MapTool.
### Requirements
### Resources
- **Website:** https://rptools.net/
- **Forums:** https://forums.rptools.net
- **Wiki:** https://wiki.rptools.info/index.php/Main_Page
- **Discord:** https://discord.gg/dZy7HeYYVY
- **Reddit:** https://www.reddit.com/r/MapTool/
- **Crowdin:** https://crowdin.com/project/maptool
## Contributing to MapTool
MapTool wouldn't be where it is today without the contributions of many people. We welcome
contributions from anyone who is interested in helping out, you don't need to be a developer to
contribute. For detailed information
about how
you can contribute to MapTool, please see our [Contributing Guide](CONTRIBUTING.md).
Recommended IDE
----------------
We currently recommend [IntelliJ IDEA](https://www.jetbrains.com/idea/) as our editor of choice
although Eclipse and other IDE's should work just fine as well. For IntelliJ IDEA, simply open the
project folder and it will detect it as a Gradle project and you should be ready to go with minimal
effort.