Instructions on a team/gang plugin :D

Hellau, Am wondering if anyone could give me an instruction on how to create a gang plugin. I don't want the code for it, but I would love if someone wrote down step by step what I should do so I can learn a little.
as an example:
Step 1) create a hashmap to store the gangs and a list to store players.
step 2) etc...
the first step was wrong I guess xD.
Anyway please if you have any interest in training me please make instructions.

I don't know if this will help you make an instructions but these are the commands I'll be creating:
Gang create <Gangname> "To create a gang"
Gang invite <Playername> "To invite a player"
Gang disband <Gangname> "To disband a gang"
Gang uninvite <Playername> "To uninvite a player"
Gang leave "To leave your gang"
Gang join <Gangname> "To join a gang"

Regards,
MrBeastie

 

BeastCraft3

You seem to have a pretty good idea what you want, why do you need us?

 

mythbusterma
I don't trust me. I only know the basic. if you know how I should do It I would love to listen

 

BeastCraft3

Try writing something out, if you have any issues you can come here. It doesn't seem like you need our help with this, at least, not yet.

 

BUMB
I would like a quick written tutorial mythbusterma . so I don't need to edit everything because I did something wrong in the start.

 

1) Create a Gang object which stores information like name, tag, member list, etc.
2) Create a GangManager object, which stores a List of the Gang objects, and has methods to return a Gang object when given an id, name, etc.
3) ???
4) Profit.

Code:java

public class Gang {
    private final int id;
    private final String name;
    private final List<UUID> members;
 
    public Gang(int id, String name, List<UUID> members) {
        this.id = id;
        this.name = name;
        this.members = members;
    }
 
    public int getId() {
        return this.id;
    }
 
    public String getName() {
        return this.name;
    }
 
    public List<UUID> getMembers() {
        return this.members;
    }
 
    public boolean isMember(UUID uuid) {
        return getMembers().contains(uuid);
    }
 
    // ... etc
}

Code:java

public class GangManager {
    private final List<Gang> gangs = new ArrayList<Gang>();
 
    public void addGang(int id, String name, List<UUID> members) {
        this.gangs.add(new Gang(id, name, members));
    }
 
    public void removeGang(int id) {
        this.gangs.remove(getGang(id));
    }
 
    public Gang getGang(int id) {
        for (Gang gang : this.gangs) {
            if (gang.getId() == id) {
                return gang;
            }
        }
        return null;
    }
}

Something like that.

EDIT by Moderator: merged posts, please use the edit button instead of double posting.

 

FerusGrim
Thanks

 

FerusGrim why..... pls read my signature.

 

Eh. I provided a standard Object with a standard manager for the Object. It happens to be slightly related to the question at hand.

However, unless he learns how to use it, he wouldn't be able to use it. And the knowledge of how to use it is more important to me than providing something that takes a few seconds to type out.

 

FerusGrim why..... pls read my comment.

BeastCraft3 Actually a Map should be sufficient enough.

 

FerusGrim I agree with you for the most part, but.... O(n) to get a Gang from it's ID? Why not use a Map<String, Gang> where the index is the gang's name? Or if you want to keep it indexed with their IDs then you could use an Integer... I don't see the point of using a List here

EDIT: this also applies to the Gang object itself. For some reason you decided to store the members in a List, O(n) is back again! Why not a Set? This will also insure there are no duplicates.

Monkey_Swag teej107 C'mon guys... He provided a class with a few getters and setters...

 

Totom3 You yourself pointed out the flaws in his spoonfed code.


Another way to use gangs would be to have a Map like this: Map<Player(or UUID), Gang>. If Gang is null under a certain player, then they aren't in one.

 

teej107 Totom3 teej107 FerusGrim
Guys... this wans't what I actually asked for.. I said I didn't want any code unless I asked. I'm not learning this properly if I get the plugin template premade. I was suppost to figure all this out my self. and yes I know how to use getters and setters, Totom3 teached me it.
I would like a easy step by step written tutorial(NO CODE!) so I can learn how the good coders would make it....

 

BeastCraft3
I supplied a step-guide above the template I gave you.

 

BeastCraft3
Ok so I don't think there's too much to say about the commands class. You can simply make a switch statement over args[0] and do whatever needs to be done. Nothing complicated over here.

For the mini-API that comes with the plugin, I'd suggest, as FerusGrim said, to use a Manager object. What I mean by that is an object that can add, remove, check for, list and clear entries (similarly to a Map). Here you'd store Gang objects. If you decide to use a Map internally, Gang would be the value of the map, and the key could be either the ID of the Gang or it's name (I'd go for the name). The advantage of wrapping a Map (in a Manager) instead of exposing it is that you can make sure it is used correctly. That may sound advanced but really, it's simple.

The Gang object itself is really not complex. Ask yourself : what do I need to store about each Gang ? The internal name, display name, influence (maybe?), ID (not necessary) and the players that are in it. Make a few getters and setters and you're done. Still no complicated stuff.