Research Tech Tree

Research: A tech tree api
Tech: An example plugin with simple mechanics.

Quick Description Research is an API plugin that implements technology trees in game. In config.yml the server owner defines what blocks and items they don't want players using. In tech.yml they define what they do want players to be able to make, break, place, and permissions for each technology. A default is provided. Players need the "research" permission node in order for the research plugin to work on them.

Research is just an API, other plugins need to provide the commands for players. A sample plugin called Tech has been provided that demonstrates giving each online player one technology point a minute. Players will need the "tech" permission node.

API: Link to use Research in your plugin

Justification: Many players enjoy the ability to jump right in minecraft and be able to build in diamond blocks right away. I am not one of those players. I get the most kick starting off restricted and developing new skills and abilities. RPG plugins do this for individual player actions, but I want to bring that kind of growth to the building and mining aspects. This plugin is for people who share my kind of play style.

The Basics: This plugin is intended to work alongside other permission and Towny/Faction type plugins, although it will include basic functionality to be usable on its own. The plugin contains an existing default technology tree based on Civilization V's, but the server owner is able to customize it or rewrite it from scratch. The plugin tracks if a player can place, destroy, or using spout craft items based on the technology they have learned. Permission nodes can also be attached to technology.

The Use Case: The best way for me to describe how this plugin works is through a use case.

ServerOwnerSue installs the plugin and decides to check out the default settings. In config.yml there are a number of lists for what a player can't do if they have no technology under their name: BlockIDs for cantPlace, cantBreak, cantCraft, and and any permission nodes they WANT their players to start with (although I might change this to nodes they want to make sure player's DONT have).

She then checks out techs.yml where she finds each tech has a description, costs, prerequisite technologies, fields for blockIDs under canPlace, canBreak, canCraft, as well as permission nodes. She decides to make a new technology called Teleportation which she adds to the bottom of the list

Teleportation:
  description: "Instant travel! Opens up personal home warps"
  cost: 10000
  prereqs: ["Archery"] #Because that makes TOTAL sense!
  permissions:
  - commandbook.home
  - commandbook.sethome
  canPlace:
  - 122
  canBreak: [122]
  canCraft: []
  # Custom events not yet available. This is for situations like a tech giving a town 10 free bonus chunks or something that is plugin specific.
  customEvents: []

Once she tuned everything to her liking Sue became sad as no other plugins are set up to use Research. She download and installs TECH, a simple plugin that allows players to set their own personal research and earns one research point for every minute they play on her server.

Integration: An API is being developed to allow other plugins that utilize groups of players (Towny/Factions/chunkyVillage/etc) to optionally tap in to this gameplay feature. It is impossible for me to accommodate all the possible ways these groups are organized and implemented. As a result technology is tracked per player. It will be up to external plugins to decide how to handle a player leaving or joining a group.

For devs the API: http://dev.bukkit.org/server-mods/research/pages/research-api/

Features:

Tech tree based on Civilization V's tree
Manages block placing, breaking, and crafting events
Basic permission manager
Basic example plugin

Permission Nodes

research (research restrictions and tracking active for player)
tech (access Tech plugin commands)