TravelAgent (Bukkit 1.12.2-R0.1-SNAPSHOT API 中文文档)

```
public interface TravelAgent
```
TravelAgent用于实体试图使用下界或末地传送门时处理相关的生成和搜索。
被应用于EntityPortalEvent和PlayerPortalEvent中以帮助开发者复制和修改原版行为。原文： The Travel Agent handles the creation and the research of Nether and End portals when Entities try to use one.
It is used in EntityPortalEvent and in PlayerPortalEvent to help developers reproduce and/or modify Vanilla behaviour.

方法概要

所有方法实例方法抽象方法
限定符和类型	方法和说明
`boolean`	`createPortal(Location location)` 尝试在指定方位附近生成一个传送门。
`Location`	`findOrCreate(Location location)` 尝试寻找指定方位附近的传送门，如果找不到则会尝试生成一个。
`Location`	`findPortal(Location location)` 尝试寻找指定方位附近的传送门。
`boolean`	`getCanCreatePortal()` 返回TravelAgent是否尝试生成目的传送门。
`int`	`getCreationRadius()` 获取以指定方位为圆心生成传送门的最大半径。
`int`	`getSearchRadius()` 获取寻找有效传送门的搜索半径数值。
`void`	`setCanCreatePortal(boolean create)` 设置TravelAgent是否尝试生成目的传送门。
`TravelAgent`	`setCreationRadius(int radius)` 设置以指定方位为圆心生成传送门的最大半径。
`TravelAgent`	`setSearchRadius(int radius)` 设置搜索有效传送门的方块半径。

- 方法详细资料
  - setSearchRadius
```
TravelAgent setSearchRadius(int radius)
```
    设置搜索有效传送门的方块半径。
    原文： Set the Block radius to search in for available portals.
    
    参数:
    
    radius - 以指定方位为圆心搜索传送门的半径
    
    返回:
    
    TravelAgent对象
  - getSearchRadius
```
int getSearchRadius()
```
    获取寻找有效传送门的搜索半径数值。
    原文： Gets the search radius value for finding an available portal.
    
    返回:
    
    当前设置的搜索半径
  - setCreationRadius
```
TravelAgent setCreationRadius(int radius)
```
    设置以指定方位为圆心生成传送门的最大半径。
    原文： Sets the maximum radius from the given location to create a portal.
    
    参数:
    
    radius - 以指定方位为圆心生成传送门的半径
    
    返回:
    
    TravelAgent对象
  - getCreationRadius
```
int getCreationRadius()
```
    获取以指定方位为圆心生成传送门的最大半径。
    原文： Gets the maximum radius from the given location to create a portal.
    
    返回:
    
    当前设置的生成半径
  - getCanCreatePortal
```
boolean getCanCreatePortal()
```
    返回TravelAgent是否尝试生成目的传送门。
    原文： Returns whether the TravelAgent will attempt to create a destination portal or not.
    
    返回:
    
    TravelAgent是否尝试生成目的传送门
  - setCanCreatePortal
```
void setCanCreatePortal(boolean create)
```
    设置TravelAgent是否尝试生成目的传送门。
    原文： Sets whether the TravelAgent should attempt to create a destination portal or not.
    
    参数:
    
    create - TravelAgent是否尝试生成目的传送门
  - findOrCreate
```
Location findOrCreate(Location location)
```
    尝试寻找指定方位附近的传送门，如果找不到则会尝试生成一个。
    原文： Attempt to find a portal near the given location, if a portal is not found it will attempt to create one.
    
    参数:
    
    location - 搜索传送门的原点
    
    返回:
    
    寻找到的传送门的方位，如果失败则会返回传递给这个方法的方位。
    
    另请参阅:
    
    createPortal(Location)
  - findPortal
```
Location findPortal(Location location)
```
    尝试寻找指定方位附近的传送门。
    原文： Attempt to find a portal near the given location.
    
    参数:
    
    location - 搜索传送门的原点
    
    返回:
    
    最近的传送门的方位
  - createPortal
```
boolean createPortal(Location location)
```
    尝试在指定方位附近生成一个传送门。
    如果传送到下界将会尝试生成一个下界传送门。
    如果传送到末地将会（重新）生成黑曜石平台并清除上方的方块。
    原文： Attempt to create a portal near the given location.
    In the case of a Nether portal teleportation, this will attempt to create a Nether portal.
    In the case of an Ender portal teleportation, this will (re-)create the obsidian platform and clean blocks above it.
    
    参数:
    
    location - 生成传送门的原点
    
    返回:
    
    成功生成传送门则返回true

接口 TravelAgent

方法概要

方法详细资料

setSearchRadius

getSearchRadius

setCreationRadius

getCreationRadius

getCanCreatePortal

setCanCreatePortal

findOrCreate

findPortal

createPortal