/** * Add a L2Object in the world.<br> * <br> * <B><U> Concept</U> :</B><br> * <br> * L2Object (including L2PcInstance) are identified in <B>_visibleObjects</B> of his current * L2WorldRegion and in <B>_knownObjects</B> of other surrounding L2Characters <br> * L2PcInstance are identified in <B>_allPlayers</B> of L2World, in <B>_allPlayers</B> of his * current L2WorldRegion and in <B>_knownPlayer</B> of other surrounding L2Characters <br> * <br> * <B><U> Actions</U> :</B><br> * <br> * <li>Add the L2Object object in _allPlayers* of L2World * <li>Add the L2Object object in _gmList** of GmListTable * <li>Add object in _knownObjects and _knownPlayer* of all surrounding L2WorldRegion L2Characters * <br> * <li>If object is a L2Character, add all surrounding L2Object in its _knownObjects and all * surrounding L2PcInstance in its _knownPlayer <br> * <I>* only if object is a L2PcInstance</I><br> * <I>** only if object is a GM L2PcInstance</I><br> * <br> * <FONT COLOR=#FF0000><B> <U>Caution</U> : This method DOESN'T ADD the object in * _visibleObjects and _allPlayers* of L2WorldRegion (need synchronisation)</B></FONT><br> * <FONT COLOR=#FF0000><B> <U>Caution</U> : This method DOESN'T ADD the object to _allObjects * and _allPlayers* of L2World (need synchronisation)</B></FONT><br> * <br> * <B><U> Example of use </U> :</B><br> * <br> * <li>Drop an Item * <li>Spawn a L2Character * <li>Apply Death Penalty of a L2PcInstance<br> * <br> * * @param object L2object to add in the world * @param newRegion L2WorldRegion in wich the object will be add (not used) */ public void addVisibleObject(L2Object object, L2WorldRegion newRegion) { // If selected L2Object is a L2PcIntance, add it in L2ObjectHashSet(L2PcInstance) _allPlayers of // L2World // XXX TODO: this code should be obsoleted by protection in putObject func... if (object instanceof L2PcInstance) { L2PcInstance player = (L2PcInstance) object; if (!player.isTeleporting()) { L2PcInstance tmp = _allPlayers.get(Integer.valueOf(player.getObjectId())); if (tmp != null) { _log.warn("Duplicate character!? Closing both characters (" + player.getName() + ")"); player.logout(); tmp.logout(); return; } _allPlayers.put(player.getObjectId(), player); } } if (!newRegion.isActive()) return; // Get all visible objects contained in the _visibleObjects of // L2WorldRegions in a circular area of 2000 units List<L2Object> visibles = getVisibleObjects(object, 2000); _log.trace("objects in range:" + visibles.size()); // tell the player about the surroundings // Go through the visible objects contained in the circular area for (L2Object visible : visibles) { // Add the object in L2ObjectHashSet(L2Object) _knownObjects of the visible L2Character // according to conditions : // - L2Character is visible // - object is not already known // - object is in the watch distance // If L2Object is a L2PcInstance, add L2Object in L2ObjectHashSet(L2PcInstance) _knownPlayer // of the visible // L2Character visible.getKnownList().addKnownObject(object); // Add the visible L2Object in L2ObjectHashSet(L2Object) _knownObjects of the object according // to conditions // If visible L2Object is a L2PcInstance, add visible L2Object in // L2ObjectHashSet(L2PcInstance) _knownPlayer of the // object object.getKnownList().addKnownObject(visible); } }