Giter VIP home page Giter VIP logo

tbc-db's Introduction

TBC-DB for CMaNGOS/mangos-tbc

A content database for mangos-tbc, and World of Warcraft Client Patch 2.4.3 - Fury of the Sunwell. It is compatible only with client 2.4.3 (build 8606).

TBC-DB is released under the GPL v3. The file (LICENSE.md) must be a part of any redistributable packages made from this software. No licenses should be removed from this software if you are making redistributable copies.

TBC-DB contains copyrighted materials that are not part of the GPL v3. Informations about copyrighted materials are located in the file (COPYRIGHT.md).

World of Warcraft content and materials are trademarks and copyrights of Blizzard or its licensors. All rights reserved. TBC-DB is part of CMaNGOS project and is not affiliated with Blizzard or its licensors.

Compatibility

The TBC-DB database is compatible with mangos-tbc core only.

Getting started

The basic principle behind this database repository is to have a single SQL file holding every table in the database. When something is changed into the database the modification is done by adding small SQL update files placed into the updates directory. Every time a user (that would be you or TBC-DB Developers) wishes to change something into the database, he/she have to create and add the right SQL file. This helps tracking what changes are made, when and where.

Installation

TBC-DB is the main content database for: tbcmangos where the world is defined with creatures, items, objects, quests, etc.

It must be applied after creating the tbcmangos database from your CMaNGOS core distribution mangos-tbc from CMaNGOS Project.

If you used the default values when installing your mangos core, simply run into a bash compatible shell (like Bash Git for Windows) the following command ./InstallFullDB.sh.

It will create a single file InstallFullDB.config .

If you have modified the default values for connecting to the database, in order to use this database repository, you will have to open InstallFullDB.config, and edit in the desired database, username and password according to how you have configured your MySQL server. Default values for mangos core are username:mangos, password:mangos, database:mangos. For security reasons, it is strongly adviced to use different username and password.

Once you have the desired database user and rights configured in MySQL, you may run again the ./InstallFullDB.sh command to load the individual data tables into your database, populate them and apply all updates since the last milestone.

There are also options that you can enable/disable in InstallFullDB.config to add SQL files related to bots, development updates or custom changes.

For a full installation guide, please refer to CMaNGOS installation instructions.

Contributing

You are welcome to contribute to this database project. There are three main ways of contributing. Choose the one fitting your skills.

  1. Open a ticket/issue on CMaNGOS issue tracker on GitHub. Describe the issue as accurately as possible, how things currently are, how things should be instead. Example: "NPC Mighty Skeleton in Western Plaguelands does not wield its weapon. It should have a sword.". You can improve your issue report by giving the ID/entry of the creature, object, quest, spell... it helps developers to find quickly where is the problem. In-game GM commands like .guid, .lookup quest (or creature, spell, object), .gobject near (or target) are great to get those informations
  2. If you have SQL knowledge you can also open a ticket/issue and provide a fix, even partial. To help you to understand the DB structure, have a look a the wiki page or feel free to ask developers in the issue report. You can also try to fix currently open issues
  3. Make a pull request. If you feel like cloning the database repository, you can test your own fixes and do a pull request that will be reviewed and discussed with you before merging

Whenever possible, provide sources about the issue to help developers to get a better understanding of the issue (wowwiki, wowpedia, wowhead, official data...). Note that everything coming from private servers is not a reliable source.

Note that the more complete your contribution is (i.e. close to a pull request), the quicker it will become part of the database. But as this is a community project, the developers will always try to help you move through the various stages of contributing!

tbc-db's People

Contributors

anonxs avatar killerwife avatar mantislord avatar x-savior avatar cala avatar grz3s avatar saltgurka avatar tobschinski avatar miraco avatar xfurry avatar nytanath avatar ratkosrb avatar cyberium avatar nicktyrer avatar sneakynick avatar neatelves avatar huifsa avatar sneakyabc avatar evildead666 avatar swater96 avatar hoechstn avatar killyana avatar adellaci avatar phatcat avatar insunaa avatar muehe avatar xinito avatar kathelas avatar neotmiren avatar wyrserth avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.