The plugin for adding Gods to the world of minecraft.

A God is an entity that exist because a player has chosen to believe in it.

A player shows his faith in a god by building an altar for his god and using the altar to pray. In this way, many gods may exist at a time, all with names created by the players.

The main purpose for believing in these Gods is to gain from the help the Gods provide (see below) and to provide some basic faction play based on ideology and culture (I.e. "My god is better than yours because apples are holy!").

Note that this does NOT mean that Gods are "free item dispensers": Gods will only bless players with items when they are pleased with the effort of their believers.
Gods will even punish a player for ignoring their divine wishes.

With Holy Lands, players can easily protect their lands from grief by simply building alters.

Another purpose is simply to get people inspired to build awesome churches for their Gods.
Check out what others have build for their God here

Altars

Building an altar is simple:

• Place a normal or redstone torch on a smooth brick block
• Place a sign on the side of the block with ONLY the name of your God written on any line
• Players can now pray to this God by right-clicking on the altar sign

If you place a normal torch, you specify a male God.
If you place a redstone torch, you specify a female God (Goddess).
Note that when building the first altar for a God, the altars position will be set as the "religion home" and believers can reach it with the /gods home command.

Rules

• Gods exist as long as players believe in them
• Gods comes into existence when players build altars to them
• Gods grow stronger from the number of believers they have
• Gods grow stronger from the number of prayers at their alters
• Gods appoints a single believer to be his priest
• Gods will bless their believers with (only) items they need
• Gods will bless their believers with health if they need it
• Priest can pray for Blessing and Cursing specific players
• Gods send their believers on quests
• Gods protect their lands around their altars.

Pleasing the Gods

As we all know, Gods are very moody entities:

• Whenever you do something which the God approve of, his mood will increase.
• Whenever you do something which the God disapprove of, his mood will decrease.
• Even when doing nothing, the Gods mood will slightly decrease. (Gods do not like being ignored)

The mood of a God has certain effects:

• Exalted Gods will give needed items, food and actively bless their believer with buffs.
• Pleased Gods will give needed items and food.
• Neutral Gods will encourage more prayers.
• Displeased Gods will complain about lack of attention.
• Angry Gods will punish their believers for lack of attention.

Any believer can check the mood of their God with the /g info command.

Item Blessings

Periodically, the God will check for his believers needs:

• When a believer has no pickaxe, the God will bless his believer with a pickaxe
• When a believer has no sword, the God will bless his believer with a sword
• When a believer is low on health, the God will bless his with health
• When a believer has no food, the God will bless his believer with food

The more powerful the God is, the more frequent the God will attend to his believers. The exact quality of the item (wood, stone, diamond) also depends on the power of the God.

Blessing Altars

A Priest can ask his God to specifically bless any player by using an altar:

• Build an altar as described above
• On the sign, write "Blessings" on line 1
• On the sign, write "on" (or anything) on line 2
• On the sign, write the name of the player on line 3

Now the priest can right-click the sign, praying to his God to bless that player!

Cursing Altars

A Priest can ask his God to specifically curse any player by using an altar:

• Build an altar as described above
• On the sign, write "Curses" on line 1
• On the sign, write "on" (or anything) on line 2
• On the sign, write the name of the player on line 3

Now the priest can right-click the sign, praying to his God to curse that player!

Commandments

Any God with respect for himself have strong opinions about what is right and wrong.

A God will periodically tell his priest about what food and creature types are considered holy and unholy.
Because the God will react swiftly with blessings and curses on his believers accordingly to these commandments, it is the priests responsibility to communicate (preach) this information to the believers in general.

Quests

Gods will periodically issue quests for their believers, for them to show their faith in him.
This may include quest for slaying mobs, sacrificing certain items etc.
If completed, all the believers will be rewarded by the God and the quest completion will act as a mass-prayer, effectivly adding significantly more belief to the God.

Sacrifices

Believers can sacrifice items to their God by burning any item of their choice.
The God will have a certain need for certain item types and it is up to the believer to find out the needs of their God at any given time.
Sacrificing items that the God needs will result in a blessing and added belief in the God, which in turn adds more power to the God.
Be warned that sacrificing items to a God which has no interest in the item or "spam-sacrificing" a God can have deadly consequences...
Gods will also issue sacrifice quests from time to time.

The Holy Book

All Gods have their "Bible" or "Holy Book", which is maintained by the priest. At any time, the priest can produce a copy of the current edition of the Holy Book with /gods bible.
The priest can edit a copy of the current edition of the Holy Book with /gods editbible.
He can also choose to set the currently held book to be the official Holy Book for his religion with /gods setbible.

Marriage

Players can marry another believer within their own religion.
After completing the simple wedding ceremony, the couple can "love" each other with the /g love command.
Married couples will add further to the happiness of their God, especially if their God is a God of love.

Holy Lands

The land around an altar is considered holy to that particular God.
Only believers of the God has access and can destroy within their Holy Land. This acts as a simple anti grief control purely based on building altars.

Conquering Holy Lands

• When using Holy Lands, a priest can call an attack on an enemy God's Holy Land by using the /g attack command.
  
• During the attack, the Holy Land is considered "contested" and no-none can build within the land.
  
• The contested state will last for 1 day or until either side of the attack has killed enough believers to resolve the conflict.
  

The God Names

By default, any player is free to believe in any obscure God name that he wishes. (Just like in real life...). To gain more control over the God names, there are 2 options:

• Use a whitelist containing the God names of the allowed Gods on the server. ONLY these Gods will be permitted on the server.
• Use a blacklist containing the God names that are disallowed on the server. Any other God name than these will be permitted on the server.

Check out the whitelist & blacklist page for the details on how to setup these lists.

See config settings below for how to enable the blacklist and whitelist.

Languages & Custom God speak

All the text for the Gods speech can be changed and customized to your needs.
You might want do adjust the tone of what a God say, expand what a God can say or even want a God to speak in another language!

All the God speech text files are found in /lang folder within the plugins folder and are by default automatically downloaded from my own server at http://www.doggycraft.dk.
(Note: To disable the download of language files, set the DownloadLanguageFile option to false in your config.yml.)
Simply use these file as templates for other languages or for adjusting the tone of voice for each God type.

Chat Formatting

Want to a players God as part of their chatname?
See here how to setup God names in the chat

Installation

Put the Gods.jar file in your /plugins folder and you are ready to go!

Commands

Permission Nodes

Note that Gods currently supports PermissionsBukkit, PermissionsEX, bPermissions and GroupManager.
Just PM me with requests for supporting other managers.

• gods.* - Player can do everything below
• gods.pray- Player can pray directly to their Gods using /g prayfor command
• gods.listen - Player can hear Gods speaking
• gods.marry- Allows the Player to marry
• gods.quest.slay - Player can participate in slaying quests
• gods.altar.build - Player can build an altar
• gods.altar.pray - Player can pray using an altar
• gods.altar.sacrifice - Player can sacrifice items using fire
• gods.god.create - Player can create (believe) in a new God
• gods.itemblessings - Player can receive item blessings from a God
• gods.blessings - Player can be blessed by a God
• gods.commandments - Player is affected by commandments of a God
• gods.curses - Player can be cursed by a God
• gods.marry - Player can marry other players
• gods.love - Player can love their partner
• gods.divorce - Player can divorce their marrige partner
• gods.accept - Player can accept proposal from a God
• gods.reject - Player can reject proposal from a God
• gods.help - Player can check the help information
• gods.info - Player can check info for each God
• gods.listen - Player can hear the words of a God
• gods.chat - Player can toggle chatting within their own religion
• gods.sethome - Player can set their religion home
• gods.home - Player teleport to their religion home
• gods.check - Player can check which God another player believes in
• gods.setpriest - Player can set the priest of a God
• gods.priest - Player can become priest of a Gods
• gods.priest.invite - Priest can invite player to his religion
• gods.priest.kick - Priest can kick player from his religion
• gods.priest.description - Priest can set description for his religion
• gods.priest.pvp - Priest can toggle pvp within his religions Holy Land
• gods.priest.alliance - Priest can declare alliance with another religion
• gods.priest.war - Priest can declare war towards another religion
• gods.priest.peace - Priest can declare peace towards another religion
• gods.priest.description - Priest can change the description of his religion
• gods.priest.bible - Priest can produce a copy of their Bible
• gods.priest.editbible - Priest can edit their Bible
• gods.priest.setbible - Priest can set a book as their Bible
• gods.holyland - Player is affected by holylands (I.e: Unable to build in holyland of another God)
• gods.list - Player can check the list of Gods
• gods.reload - Player can reload the Gods configuration file
• gods.updates - Player will see notifications about new updates to the Gods plugin
  
  

Configuration

Upcoming features

• Admin commands for setting power, type, names for Gods
• Holy Artifacts
• Titans
• God "drama": Jealousy, weddings, love, hate, war and family relations between Gods.
• Prophecies
• Holy Battles
• Pilgrimages
• Crusades
• Prayers
• Miracles
• More effects/feedback when destroying altars
• Specific permissions for each God using the whitelist
• Specific language files for each God using the whitelist
• Gods periodically manifests themselves self in the world in form of a mob
• Server history as seen from each religion noted in their Holy Book
• God personalities
• Direct PvP/Battlefield action by Gods
• More commandments
• Weather altars
• Altars deteriorate the surrounding blocks if their God dies out
  
  

Do you want to support this plugin?

Disclaimers

This plugin contacts curse.com and checks for newer versions by using the Curse ServerMOD API.
Opting out of this service can be done by editing config.yml and changing DisplayUpdateNotifications to false.

This plugin utilises Hidendra's plugin metrics system, which means that the following information is collected and sent to mcstats.org:

A unique identifier
The server's version of Java
Whether the server is in offline or online mode
The plugin's version
The server's version
The OS version/name and architecture
The core count for the CPU
The number of players online
The Metrics version

Opting out of this service can be done by editing config.yml and changing MetricsOptOut to true.

Want to contribute? Gods is open source!

Check out the official repository on github