Package games.stendhal.server.entity.mapstuff.portal

Class LevelCheckingPortal

java.lang.Object

marauroa.common.game.Attributes

marauroa.common.game.SlotOwner

marauroa.common.game.RPObject

games.stendhal.server.entity.Entity

games.stendhal.server.entity.mapstuff.portal.Portal

games.stendhal.server.entity.mapstuff.portal.LevelCheckingPortal

All Implemented Interfaces:

UseListener, Killer, Cloneable, Iterable<String>, Serializable

public class LevelCheckingPortal
extends Portal

A portal which allows only certain levels of player to use it.

Author:

hendrik

Nested Class Summary

Nested classes/interfaces inherited from class marauroa.common.game.RPObject

RPObject.ID

Field Summary

Fields

Modifier and Type	Field	Description
static int	DEFAULT_MAX	The default maximum level.
static int	DEFAULT_MIN	The default minimum level.
protected boolean	forceStop	Override continuous movement setting.
protected boolean	instantAction	Immediate execution of action when player says password.
protected int	listeningRadius	Radius at which portal will "listen" for speaking players.
protected String	passwordAcceptedMessage	Optional message to give when correct password used.
protected String	passwordRejectedMessage	Optional message to give when incorrect password used.
protected int	portalID	ID for the portal
protected static int	portalIDCounter
protected ChatAction	rejectedAction	Optional action to take when access is rejected.
protected String	rejectedMessage	The message to give when rejected.
protected String	requiredPassword	Optional password to use portal.

Fields inherited from class games.stendhal.server.entity.mapstuff.portal.Portal

ATTR_FACE, ATTR_HIDDEN, ATTR_OFFSET, ATTR_USE

Fields inherited from class games.stendhal.server.entity.Entity

area

Fields inherited from class marauroa.common.game.RPObject

INVALID_ID

Fields inherited from class marauroa.common.game.SlotOwner

slots

Constructor Summary

Constructors

Constructor	Description
LevelCheckingPortal(int minLevel, int maxLevel)	Creates a level checking portal.
LevelCheckingPortal(int minLevel, int maxLevel, String rejectMessage)	Creates a level checking portal.

Method Summary

Modifier and Type	Method	Description
int	getListeningRadius()
String	getPasswordAcceptedMessage()
String	getPasswordRejectedMessage()
String	getRejectedMessage()	Gets the message to send when player is denied access to portal.
String	getRequiredPassword()	Gets the password required to use the portal.
boolean	hasInstanceAction()	Checks if the portal executes an action immediately after password is said.
protected boolean	isAllowed(RPEntity user)	Determine if this portal can be used.
void	logic()
boolean	onUsed(RPEntity user)	Use the portal, if allowed.
boolean	playerIsPortalUnlocked(Player player, Portal portal)
protected void	rejected(RPEntity user)	Called when the user is rejected.
protected void	sendMessage(RPEntity user, String text)	Wrapper to send a message to a user, without getting lost.
void	setForceStop(boolean forceStop)	Sets flag to override continuous movement & force entity to stop.
void	setInstantAction(boolean instant)
void	setListeningRadius(int radius)	Sets the radius at which the portal will "hear" speaking players.
void	setPasswordAcceptedMessage(String message)	Set the password accepted message.
void	setPasswordRejectedMessage(String message)	Set the password rejected message.
void	setRejectedAction(ChatAction rejectedAction)	Initiates an action to take on rejection.
void	setRejectedMessage(String message)	Set the rejection message.
void	setRequiredPassword(String password)

Methods inherited from class games.stendhal.server.entity.mapstuff.portal.Portal

generateRPClass, getDestinationReference, getDestinationZone, getFaceDirection, getIdentifier, getOffset, hasFaceDirection, hasOffset, isHidden, loaded, onPushedOntoFrom, onUsedBackwards, setDestination, setFaceDirection, setFaceDirection, setHidden, setIdentifier, setIgnoreNoDestination, toString, usePortal

Methods inherited from class games.stendhal.server.entity.Entity

describe, getAdjacentNodes, getArea, getArea, getCursor, getDescription, getDescriptionName, getEntitySlot, getHeight, getName, getOrigin, getResistance, getResistance, getTitle, getWidth, getX, getY, getZone, hasDescription, isInSight, isObstacle, nextTo, nextTo, notifyWorldAboutChanges, onAdded, onMoved, onRemoved, setCursor, setDescription, setEntityClass, setEntitySubclass, setMenu, setPosition, setResistance, setSize, setVisibility, slotIterator, slots, squaredDistance, squaredDistance, stopped, update

Methods inherited from class marauroa.common.game.RPObject

addEvent, addLink, addLink, addMap, addSlot, addSlot, applyDifferences, clearEvents, clearVisible, clone, containsKey, equals, events, eventsIterator, fill, get, getBaseContainer, getBoolean, getContainer, getContainerBaseOwner, getContainerOwner, getContainerSlot, getDifferences, getDouble, getFromSlots, getID, getInt, getLink, getLinkedObject, getMap, getSlot, has, hashCode, hasLink, hasMap, hasSlot, hide, isContained, isEmpty, isStorable, maps, put, put, put, put, readObject, remove, removeLink, removeMap, removeSlot, resetAddedAndDeleted, resetAddedAndDeletedMaps, resetAddedAndDeletedRPLink, resetAddedAndDeletedRPSlot, setAddedMaps, setAddedRPSlot, setContainer, setDeletedMaps, setDeletedRPSlot, setID, size, slots, slotsIterator, store, unhide, unstore, writeObject, writeObject, writeToJson

Methods inherited from class marauroa.common.game.SlotOwner

deserializeRPSlots, fill, serializeRPSlots

Methods inherited from class marauroa.common.game.Attributes

add, applyDifferences, get, getBool, getDouble, getInt, getList, getLong, getRPClass, has, instanceOf, iterator, put, put, put, put, put, readFromMap, remove, resetAddedAndDeletedAttributes, setAddedAttributes, setDeletedAttributes, setRPClass, setRPClass, toAttributeString

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from interface games.stendhal.server.entity.Killer

clone

Field Details

DEFAULT_MAX

public static final int DEFAULT_MAX

The default maximum level.

See Also:

Constant Field Values

DEFAULT_MIN

public static final int DEFAULT_MIN

The default minimum level.

See Also:

Constant Field Values

instantAction

protected boolean instantAction

Immediate execution of action when player says password.

listeningRadius

protected int listeningRadius

Radius at which portal will "listen" for speaking players.

passwordAcceptedMessage

protected String passwordAcceptedMessage

Optional message to give when correct password used.

passwordRejectedMessage

protected String passwordRejectedMessage

Optional message to give when incorrect password used.

portalID

protected int portalID

ID for the portal

portalIDCounter

protected static int portalIDCounter

rejectedMessage

protected String rejectedMessage

The message to give when rejected.

requiredPassword

protected String requiredPassword

Optional password to use portal.

rejectedAction

protected ChatAction rejectedAction

Optional action to take when access is rejected.

forceStop

protected boolean forceStop

Override continuous movement setting.

Constructor Details

LevelCheckingPortal

public LevelCheckingPortal(int minLevel,
 int maxLevel)

Creates a level checking portal.

Parameters:

minLevel - The minimum level allowed to pass.

maxLevel - The maximum level allowed to pass.

LevelCheckingPortal

public LevelCheckingPortal(int minLevel,
 int maxLevel,
 String rejectMessage)

Creates a level checking portal.

Parameters:

minLevel - The minimum level allowed to pass.

maxLevel - The maximum level allowed to pass.

rejectMessage - The custom rejection message.

Method Details

isAllowed

protected boolean isAllowed(RPEntity user)

Determine if this portal can be used.

Parameters:

user - The user to be checked.

Returns:

true if the user can use the portal.

rejected

protected void rejected(RPEntity user)

Called when the user is rejected. This sends a rejection message to the user.

Parameters:

user - The rejected user.

getPasswordAcceptedMessage

public String getPasswordAcceptedMessage()

Returns:

Message when password is accepted.

getPasswordRejectedMessage

public String getPasswordRejectedMessage()

Returns:

Messager when password is rejected.

getListeningRadius

public int getListeningRadius()

Returns:

Radius at which portal detects player speech.

getRejectedMessage

public String getRejectedMessage()

Gets the message to send when player is denied access to portal.

Returns:

Rejected message

getRequiredPassword

public String getRequiredPassword()

Gets the password required to use the portal.

Returns:

Required password

hasInstanceAction

public boolean hasInstanceAction()

Checks if the portal executes an action immediately after password is said.

Returns:

instantAction

playerIsPortalUnlocked

public boolean playerIsPortalUnlocked(Player player,
 Portal portal)

logic

public void logic()

Overrides:

logic in class Portal

onUsed

public boolean onUsed(RPEntity user)

Use the portal, if allowed.

Specified by:

onUsed in interface UseListener

Overrides:

onUsed in class Portal

Parameters:

user - that wants to pass.

Returns:

true if passed , false otherwise.

sendMessage

protected void sendMessage(RPEntity user,
 String text)

Wrapper to send a message to a user, without getting lost.

Parameters:

user - The user to send to.

text - The message to send.

setInstantAction

public void setInstantAction(boolean instant)

Parameters:

instant - Use portal automatically.

setPasswordAcceptedMessage

public void setPasswordAcceptedMessage(String message)

Set the password accepted message.

Parameters:

message - Optional message to be given when correct password used.

setPasswordRejectedMessage

public void setPasswordRejectedMessage(String message)

Set the password rejected message.

Parameters:

message - Optional message to be given when incorrect password used.

setListeningRadius

public void setListeningRadius(int radius)

Sets the radius at which the portal will "hear" speaking players.

Parameters:

radius - Distance at wich portal listens for players speaking.

setRejectedMessage

public void setRejectedMessage(String message)

Set the rejection message.

Parameters:

message - The message to give when rejected.

setRequiredPassword

public void setRequiredPassword(String password)

Parameters:

password -

setRejectedAction

public void setRejectedAction(ChatAction rejectedAction)

Initiates an action to take on rejection.

Parameters:

rejectedAction - ChatAction to execute.

setForceStop

public void setForceStop(boolean forceStop)

Sets flag to override continuous movement & force entity to stop.

Parameters:

forceStop - If true, entity is forced to stop movement.